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Preface 

This handbook contains documentation for all the standard Alto sendees intended for use by non- 
programmers. It is divided into seven sections, separated by heavy black dividers: 

The Alio Non-programmer’s Guide , which has most of the general information a non- 
programmer needs. 

The Bravo manual, which tells you how to prepare and edit text documents on the Alto. 

The Laurel manual, which tells you how to send, receive, and manipulate messages using our 
inter-Alto electronic mail system. 

The Markup and Draw manuals, which tell you how to add illustrations to documents. The 
Non-programmer’s Guide contains some introductory material on illustrations. 

Finally, two reference manuals, one for Ftp, which transports files between machines, and 
one for Neptune, which provides facilities for managing files on your Alto disk. These 
manuals supplement the introductory information on these two programs in the Non- 
programmer’s Guide. 

If you are new to the Alto, start at the beginning of the Non-programmer’s Guide. Read the first 
four sections there, and then the first two sections of the Bravo manual. Fairly early you should 
also learn about Laurel, since much day-to-day communication takes place using it. After that, you 
should be able to find what you need by looking at the tables of contents and browsing through the 
rest of the material. If you have trouble, don’t hesitate to ask an expert for help. 

This handbook was originally prepared by Butler Lampson, and the present edition is the 
responsibility of Ed Taft 
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1. Introduction 

This document is intended to tell you what you need to know to create, edit, and print text and 
pictures on the Alto. It doesn’t assume that you know anything about Altos, Maxc, IFS, or any of 
the other facilities available to you. 

You will find that things are a lot clearer if you try to learn by doing. This is especially true when 
you are learning to use any of the services which use the display. Try out the things described here 
as you read. 

Material in small type, like this paragraph, deals with fine points which can be skipped on first reading (and perhaps on 
subsequent readings as well). 

Much of the documentation in this Guide is intentionally incomplete. More comprehensive 
information about almost all of the programs and services described here may be found in various 
on-line documents. Section 9 contains a summary of these and instructions for obtaining your own 
copies of any that you need. 
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2. Getting started 

jj To do anything with an Alto, you must have a disk pack. This is a circular, yellow or white object 

,f about 15 inches in diameter and 2 inches high. Your secretary can tell you how to obtain a new 

one from the stock kept by your organization. 

; n Initialize your disk 

e 

The next step is to get the disk initialized with copies of all the programs you will need to use. 
Here is how to do this: 
m 

Obtain the disk pack labeled Basic Non-Programmer'S Disk. Find an Alto that has two disk 
drives, each with four square lights, a white switch and a slanted plastic window. Load the Basic 
tive Non-programmers Disk into the drive labeled 0. You do this as follows: 

s 

n The drive should have the white switch in the LOAD position, and the white LOAD light 

should be lit. Open the door by pulling down on the handle. Put in the disk by holding it 
flat, with the label facing you, and pushing it gently into the drive until it stops. Then gently 
close the door and push the white switch to RUN. The white LOAD light will go out, and 
after about a minute the yellow RUN light will go on. The disk is now loaded and ready to 
go. If anything else happens, you need help. 

On many double-disk Altos, the two disk drives are not labelled. The drive mounted inside the same cabinet as the Alto 
is drive 0. and the one sitting on top of the cabinet is drive 1. Also, some Altos have a switch on the back of the 
keyboard housing labelled NORMAL/ALTERNATE. Be sure that this switch is in the NORMAL position. 

Now start the Alto. This is done by pushing the small button on the back side of the keyboard, 
near the thick black cable. Pushing this button is called booting the Alto. It resets the machine 
completely, and starts it up working on the disk you have just loaded. After you boot the machine, 
it will tell you at the top of the screen what it thinks the state of its world is, and then it will print a 
">" about halfway down the screen. When the screen looks like that, anything you type will be 
read by the Executive, whose basic job is to start up the service you want to run. There is a section 
on the Executive later in this document. For now, you will find everything you need to know right 
here. 

You are going to use a program called CopyDisk, which copies everything on the main disk (which 
you just loaded) onto another disk which you will load into the disk drive labeled 1. This copying 
erases anything which is already on the disk in disk drive 1, so you should be very careful not to 
copy onto a disk which has anything you want to keep. Load your new disk into the disk drive 
■ labeled 1, doing just what you did to load the Basic NON-PROGRAMMER'S Disk into drive 0. 

The CopyDisk program is not present on the Basic Non-programmeR’S Disk, but it is available 
through a service called the NetExec, which can load a small number of commonly-used programs 
from the Ethernet. To start the NetExec, type 

> NetExec CR 

The CR stands for the carriage RETURN key on the keyboard. In this and later examples, what you 
type is underlined in the example, and what the Alto types is not. On the screen, of course, there 
won’t be any underlining. It doesn’t matter whether you capitalize letters or not; the capitalization 
in this manual is chosen to make reading easier. 

Within a few seconds, the NetExec will start up. The screen will look much the same as it did 
while the Executive was running, but with "Net Executive" in the upper left comer. Now type 

> CopyDisk CR 

After a few more seconds, CopyDisk will start up, identify itself, and display a prompt of You 
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should now go through the following dialogue: 

* Copy from: PP0 CR the digit zero, not the letter O 

Copy to: PP1 CR 

Copying onto DPI will destroy its old contents. 

Are you sure this is what you want to do? [Confirm] Yes 
Are you still sure? [Confirm] Yes 

Now CopyDisk will copy the.contents of the Basic Non-Programmer'S Disk (dpO, "the Disk 
Pack in drive 0") onto your new disk pack (dpI). This takes about two minutes. While it is 
running, it records its progress by moving the cursor from the top of the screen to the bottom; this 
happens twice: once while the disk is being copied and again while the copy is being checked for 
correctness. When it is done, if all went well it will display the message "Done. DPO and DPI are 
now identical." followed by the prompt. Now type 

* Quit CR 

to exit CopyDisk and return control to the Executive. If something goes wrong, the message "Copy complete, 
but do not trust DPI" will appear. This means that there is something wrong either with the Alto or with one of the 
disk packs. Consult your local support staff. 

Now you can take both disks out of the machine. Before you do, you should tell the Executive that 
you are finished, by typing 

> Quit CR 

You will see that after a couple of seconds the screen goes blank and starts to display a white 
square that jumps around. This is an indication that the memory test program is running properly; 
an Alto should always be left in this state when it is not being used. 

Now take out both disks, by pushing the white switch on each drive to LOAD. The yellow ready 
light should go out, and about 25 seconds later the white LOAD light should go on. Now you can 
open the door (against a slight resistance) and remove the disk. Put the Basic NON-PROGRAMMER’S 
Disk back where you found it. 

If you cannot find an Alto with two disk drives, you can do a CopyDisk from one standard (single-drive) Alto to 
another: the procedure for doing this is described in section 8.6. Since it is a little more complicated than the method 
just given, a novice should use it only as a last resort 

Label your disk 

Before doing anything else, put a label on the new disk with your name, and any other identifying 
information you like. This is best done by preparing a paper label that can be slipped underneath 
the plastic insert on the front edge of the disk pack. Now you can take the new disk to any Alto, 
load it in, boot the machine by pushing the button on the back of the keyboard, and start working. 

Name your disk 

When you do this, if you look at the information displayed at the top of the screen just after you 
do the boot, you will see that it Says 

— OS Version x/x Alto #xxx NoName — Basic Non-programmer’s Disk — 

This is because your new disk is an exact copy of the Basic Non-programmer'S Disk, which has 
no owner, and owner and disk name information got copied along with everything else. To give the 
disk your own name as owner, you should type 

>Install^ R 


to the Executive. It will ask you whether you want the "long installation dialogue"; answer No. 
When it asks you for your name, type in your Maxc or 1FS account name (usually just your own 
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last name), followed by a CR. When it asks you for a disk name, choose a suitable one and type 
that in, again followed by a CR. Next it will ask you whether you want to give your disk a 
password. If you do this, the Alto will ask you for the password every time you boot it, and won’t let you do 
anything until you provide it correctly. This provides a modest level of security for the information on your disk. If 
you do give your disk a password, it is best to use your Maxc or IFS password, since the Alto will then know it and use 
it automatically whenever you communicate with Maxc or IFS. Don't forget the password, since there is no simple way to 
find out what it is, and you will need an expert to get access to anything on your disk. 

There will be a pause for a few seconds, and then the Executive will come back, if you assigned a 
password to your disk, you will be asked for it first. Now your name is installed on the disk, and the system 
will display it near the top of the screen whenever the Executive is in control, and will put it on the 
cover page of anything you print 

After you initialize a disk, you have to edit your user profile, discussed in section 2.4 of the Bravo 
manual, and your Laurel profile, described in section 3.6 of the Laurel manual. If you are reading 
this manual for the first time, you will be told how to do these things at the appropriate points. 
This is mentioned here so that you will remember it next time you initialize a disk. 


3. The Executive and the NetExec 

e The Executive is the program to which you are typing right after a boot, and whenever any other 

program finishes its job. It has a large display area in the middle where your typing and the 
Executive’s responses appear. Above this the Executive displays a digital clock and some other 
useful status information: the versions of the Executive and the operating system, the owner name 
Y and disk name installed on the disk, the Ethernet address of the Alto you are using, and the 

number of free pages on the disk. Whenever you call another program, the Executive’s display is 
erased and replaced by that of the program that you called. 


3.1 Correcting typing errors 

When you are typing at the Executive and you make a mistake, there are a few special keys you can 
type to correct the mistake. The BS (backspace) key erases the last character you typed. Holding 
down the CTRL key and typing W erases the last word you typed. The act of holding down CTRL 
and typing W is called control-W and is denoted by W c , and similarly for other control characters. 
The del key cancels the command you were typing completely; it prints "XXX", and then starts a 
new line with a fresh ">" character. Nearly all programs accept A c (control-A) as a substitute for BS. 


3.2 Starting a program 

As we said before, the Executive is for starting up other programs which do the work you want 
done. To start a program called Alpha, you just type 

> Alpha CR 

It doesn’t matter whether you type in capitals, lower case, or a mixture of the two. If the program 
needs some other information about what to do, you type that after the name of the program. For 
example, there is an Executive command to type out a document on the screen. Suppose you want 
to type out the document called "Notes". You just say 

> Type Notes CR 


The Executive won’t ever do anything until you type the final CR; if you change your mind, just 
type del to cancel the command any time before you type the CR. 
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Certain operations, such as Type, are performed entirely by the Executive itself, whereas most others are performed by 
separate programs (also called subsystems ) kept on your disk or obtained from the Ethernet Ignore this distinction for 
now. 


3.3 Aborting 

You can usually stop what is going on and get back to the Executive by holding down the left-hand 
SHIFT key and striking the SWAT key, which is a blank key in the lower right comer of the 
keyboard on Alto-Is, in the upper right corner on Alto-Ils. If this doesn’t work, you can push the 
boot button. 


If you push the SWAT key while holding down both CTRL and SHIFT, you will find yourself talking to a service called 
Swat which is of no interest to non-programmers. Usually no harm is done if this happens; you can get back to what 
you were doing before by typing P c (control-P; hold down the CTRL key and type P). 


j 


1 1 
jj 
i ii 
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3.4 The Net Exec 

The NetExec is a program much like the Executive in that its main purpose is to start up other 
programs for you. Unlike the Executive, it loads programs from a boot server available via the 
Ethernet rather than from your own disk. The NetExec makes available certain programs (such as 
hardware diagnostics) that are used infrequently and that most users won’t wish to keep on their 
own disks. Also available are several programs useful for recovering from various sorts of disasters 
that may make it impossible for you to invoke the normal Executive. 

The NetExec may be started in either of two ways. If the Executive is already running, you may 
simply type 

> NetExec CR 

A fuzzy cursor will appear in the center of the screen for a few seconds, and then the NetExec will 
start up. If the Executive is not running, you can invoke the NetExec directly by holding down the 
BS key and the ’ (quote) key and then pushing and releasing the boot button. Keep the keys 
pressed down until you see a fuzzy cursor in the center of the screen; this can take up to 5 seconds. 

The NetExec’s display looks much like the Executive’s, but the herald contains the words "Net 
Executive". The type-in conventions are identical to the Executive’s. To start up a program from 
the NetExec, simply type the name of that program followed by CR. 

Any time this manual instructs you to "use the NetExec to invoke p'\ where p is the name of some 
program, you should follow the above procedure. An example of this was given in the instructions 
for using CopyDisk to initialize your disk (section 2). 

The Executive also has a few commands for invoking programs directly from the Ethernet, without your first having to 
start up the NetExec. At the present time, these programs are Chat, FTP, and Scavenger. More precisely, these 
commands will obtain the correspondingly-named programs from your disk if they are present and from the Ethernet 
otherwise. 
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4. Files 

The Alto stores on your disk all of the material you are working on (text and pictures), as well as 
most of the programs which provide the various services described here. The named unit of storage 
on the disk is called a file. Each different document you handle will be stored on its own file. The 
facilities for identifying files are not ideal, but you will get used to them after a while. Better 
facilities are the subject of current research. 

A file is identified by its name, which is a string of letters (upper and lower case can be used 
interchangeably), digits, and any of the punctuation characters +—.!$. A file name can have two 
parts, which are called the main name and the extension', they are separated by a period. For 
example, "Alto.Manual" is a file name, with main name "Alto" and extension "Manual". File 
names cannot have blanks in them, or any punctuation characters except the ones just mentioned. 
A file name must not have more than 39 characters; most people don’t notice this restriction. 
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4.1 Naming conventions 


It is important to name your files in some systematic way, using the extension to tell what kind of 
file it is, and the main name to identify it For instance, useful extensions might be Memo, Letter, 
Note, Figure, Calendar. If you are a secretary keeping material for several people on one disk, you 
can stick the person’s initials in front of the extension, e.g. BWLmemo, JGMmemo etc. If you 
don’t have anything specific in mind, it is customary to make the extension the same as the name of 
the program that creates the file, e.g., Report.bravo for a document that doesn’t have any special 
properties, and is written using Bravo. 


Here is a modest list of extensions commonly encountered on Non-programmers' disks: 

.al Alto display-format font file 

.boot A file that can be booted from 

.bravo Bravo-format text file 

.cm Command file for the Executive or other programs 

.image Runnable Mesa program (subsystem) 

.press Press-format file (suitable for printing) 

.run Runnable Bcpl program (subsystem) 

.- An Executive command that is executed directly by the Executive (there is no actual 

file corresponding to this name). 


The Alto doesn’t care whether you capitalize letters in file names or not (i.e., ALPHA and alpha 
and aLpHa refer to the same file), but it is a good idea to use capitalization to make names more 
readable. This is especially useful when a name consists of more than one word, since blanks are 
not allowed in file names: e.g., TripReport or MasterLisL 


4.2 File name patterns 

The Executive provides some simple facilities for handling files. First of all, it allows you to name 
a group of files by using file name patterns containing the magic characters and The 

character stands for any string of characters. For example, the pattern "*.mcmo" stands for all the 
files which have the extension "memo", and the pattern "*.BWL*” stands for all the files which 
have BWL as the first three characters of the extension. The "it" stands for any single character; 
for instance, "###.memo" stands for all the files which have a three character main name and 
the extension "memo". If you are curious to see what a pattern expands into, you can type X c immediately after 
typing it to get it expanded. 


If you type a file name or a pattern to the Executive, and then type a TAB, it will give you a list of 
all the files whose names start with that name. So, for example, typing 

>*.BWL tab 




8 


Alto Non-programmer's Guide 


will get you a list of all files which have an extension starting with the characters BWL. 

Another useful thing to know is this: if you are in the process of typing a file name to the 
Executive, and you type ESC, it will add as many characters as it can to complete a file name. If 
you type "?", it will give you a list of all the files which start with what you have already typed; 
you can then go on and finish the file name. 

Here is a summary of magic characters for getting file names expanded: 

ESC completes the file name if possible; if not, completes as much as it can, and flashes the 
screen. 

TAB shows you all the file names which match what you have typed since the last blank, and 
erases what you typed. 

? like TAB. but doesn't erase anything. 

X c retypes the command line with all file name patterns replaced by the list of file names they 
expand to. 

There are two more simple commands for dealing with files. To delete a file, or a group of files, 
type 

>Delete filel file2 ..P 

Warning: once you have deleted a file, you cannot get it back. Proceed with caution, if you have 
enabled version numbers and there is more than one version of a file, the one with the lowest version number gets 
deleted. 

To get the contents of a text file printed on the screen, type 
> Type /?/e CR 

If the contents won’t fit on the display, the Alto will show you as much as will fit, then ask if you 
want to see more. If you do, just type a space; if you want to stop, type No. 

When the Executive is running, it displays two lines of status information near the top of the 
screen. Included in this information is the amount of space which is left for storing files. This 
space is measured in disk pages ; it takes about 5 disk pages to store one page of text. It is prudent 
to keep at least 150 disk pages available; if your disk has fewer, you should delete some files, 
perhaps after sending them to a file server (see section 6). 


At this point you know enough to use Bravo to begin creating and editing text. Bravo 
is described in its own manual, which is part of the Alto User’s Handbook. You should 
start reading the Bravo manual, and not try to continue with this guide until you have 
become familiar with the material in the first two sections of the Bravo manual The 
remainder of this guide contains more information about the Alto which you won’t need 
on the first day, but will probably want in the first week. 

Because much of our day-to-day communication takes place by means of our Alto- 
based electronic mail system, you should also start learning to use Laurel. Begin by 
reading the first two sections of the Laurel manual, which is also part of the Alto 
User’s Handbook. 
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There are various ways in which your Alto disk can become damaged. If this does happen, the 
procedures described in this section will almost always allow you to recover the disk, or at worst 
will let you copy files from the sick disk to a healthy one. It is probably a good idea to get some 
help with this if you are not experienced. 

Here are the symptoms of trouble: 

You can’t boot the disk and get to the Executive. 

You are out of disk space, but you think you should have plenty: in other words, some disk 
space has apparently gotten lost. 

You get an error message from some service which says something about disk errors or file 
errors, and perhaps recommends that you should run the Scavenger. 

You hear a funny buzzing noise from the disk for a couple of seconds, after which the 
service you are using breaks in some way. 


It may be that the problem is caused by an incompatibility between the disk drive on which your disk pack was written, 
and the disk drive on which you are trying to use it. This is a likely cause of your problems only if you have been 
moving the pack from one machine to another, and if you notice that it works properly on some machines but not on 
others. If your problem is caused by disk incompatibility, the procedures described below won't do you much good. 
Instead, you should report the problem to the hardware maintenance staff, so that the offending disk drive can be 
realigned, and make yourself a new disk pack on a machine known to be in alignment You can transfer files from the 
old pack to the new one using the procedure described in section 6.5. 

The first step is to run a program called Scavenger. If your disk is healthy enough to let you boot 
and use the Executive, you can just invoke the Scavenger by typing 

> Scavenger CR 

If it isn’t, you should use the NetExec to invoke Scavenger, as described in section 3.4. 

If that doesn’t work, hold down just the BS key and press the boot button: this should give you the dancing white 
square of the memory diagnostic. If it doesn’t, either your Alto’s Ethernet connection is broken, or the boot server that 
provides Alto programs over the Ethernet is down or unavailable. Either find another Alto without these problems, or 
load in a disk which is still in good shape and has the Scavenger program on it, invoke the Scavenger, and then unload 
the good disk and load your sick one. 

The Scavenger will ask you whether you want to change disks, and give you a chance to do so if 
you say Yes. Then it will ask you if it can alter your disk to correct errors’, say Yes. 

The Scavenger will now work for about a minute. As it runs, it may ask you whether it is OK to 
correct "read errors". If they are "transient" errors, answer Yes fearlessly: if they are "permanent" 
errors, it is best to ask for advice from an expert. When the Scavenger is done, it will tell you what 
it found. If it has succeeded in making your disk healthy, you can go about your work. Delete the 
files Garbage. $ and ScavengerLog which the Scavenger leaves around. It is a good idea to go 
through this scavenging procedure once a month or so, just to keep your disk in good shape. 

If things are still in bad shape (i.e„ you can’t boot and run the Executive), the next step is to boot the NetExec again 
and type 

> NewOS CR 

This should get you a fresh copy of the operating system, which will ask you whether you want to Install. You should 
say Yes, and go through the Install procedure described in section 2. If all goes well, you will then find yourself talking 
to the Executive and can proceed normally. 

If this doesn’t work, there is one more step to try. Boot the NetExec again and this time type 
>FTP CR 


This should get you the FTP program described in section 6.3; use it to transfer the files <Allo>Executive.run and 
<Alto>SysFontal from a file server (Maxc or IFS). Then bool the Scavenger as described above and run it again. If 
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this fails, you should consult an expert. If no expert is available, you can boot FTP again, and use it to transfer files 
from your broken disk to a file server or to a clean disk on another Alto (made using the procedure described in section 


The Scavenger leaves all the stuff which it wasn't able to put into a recognizable file on a file called Garbage.!, and it 
leaves a readable record of everything it did on another file called Scavengerlxtg (unless it tells you that you have a 
beautiful disk). There are iwo kinds of entries in ScavengerLog: names of files removed from the directory or otherwise 
modified, and names of file pages which were put into Garbage.!. 


5.1 Reporting problems 

If your Alto itself is broken, obtain a trouble report form, fill it out, and leave it in the proper 
place; procedures for doing this depend on your location. 

If you have trouble with Bravo, report it using the procedure in section 4.3 of the Bravo manual. If 
you have trouble with Laurel, see section 4 of the Laurel manual. 

For other problems, consult your local expert. 


| 
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ction 6. File servers 

Many uses of the Alto require you to communicate with a shared file server , which can store files 
u belonging to a number of different users. A file server’s disk typically has hundreds of times the 

capacity of your own Alto disk. Moving non-current files to a file server is a way to free up space 
on your own disk for other things, and a file server is a good place to put documents you want 
other people to be able to get at. 

Each organization typically has at least one file server of its own. To make any use of your 
organization’s file server, you must first obtain an account and password; to do this, consult your 
er local support staff. Your account name will usually be your own last name, and your password 

should be six or more characters long and unpronounceable. 

If There are presently two types of file server, IFS and Maxc. An 1FS (which stands for Interim File System. 

as improved facilities are under development) is an Alto with some large disks attached to it and dedicated 
to the one task of being a file server. Many Ifss exist at present. Maxc is a large, general-purpose 
time-sharing system, only one of whose purposes is to be a file server. There are only two Maxc 
systems (called Maxcl and Maxc2), both of which belong to Parc. 

If you are at Parc, you should obtain accounts both on Ivy (the name of Parc’s Ifs) and on Maxc. 
If you are outside Parc, you will need an account on your organization’s own IFS, and you will have 
to find OUt its name. At present, many users outside Parc are also assigned accounts on Maxc because the Laurel 
message system uses Maxc as a central post-office, and you have to have a Maxc account in order to keep a mailbox 
there. This state of affairs is likely to change in the near future. 

While Ifs and Maxc are fundamentally different sorts of machines, in their capacities as file servers 
they are substantially the same. We shall first describe the facilities common to the two types of 
systems. Later sections will deal with additional facilities unique to one or the other. 


6.1 Logging in 

Before trying to access a file server from your Alto, you should first tell the Alto your account name 
and password. If you have given your account name to Install as the owner name for your disk, 
however, the Alto already knows it, and if you used your file server password as your disk 
password, it knows that too and you can skip to section 6.2. Otherwise, you can give the necessary 
information by typing to the Executive: 

> Login CR 

You will now be asked for your name and password. Type in each one in turn, ending each with a 
CR or space. Note that it assumes your file server account name is the same as your disk owner 
name; if this is the case, you can just type CR to confirm it, and go on to give your password. If it 
isn’t, type del, and then give the account name you want to use. Once you have done this Login, 
your Alto will automatically identify you to file servers whenever necessary. If you boot your Alto, 
it will forget this information, and you must Login again. 

Note that Login only records your name and password; it does not connect you to a file server. If 
you don’t do a Login, programs that access file servers will automatically ask you for the Login 
information when they first run, and will record it just as Login does. 

If you wish, you can supply a password for your disk when you Install (see section 2). If you do 
this, you will have to type the password whenever you boot the Alto, but it will be used 
automatically as your file server password, unless you override it with a Login command. The 
password is stored on your disk in encrypted form, so it cannot be stolen by someone who paws 
around on your Alto disk. 
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6.2 About files on IFS and Maxc 

IFS and Maxc file names look very much like Alto file names, but they have two more parts: a 
directory and a version number. On IFS, the format is 

<.direclory>name.extension\version 
whereas on Maxc the format is 

(directory)- name. ex tension', version 

Each user who has an account on a file server has his own directory, named by his user name. If 
you name a file without specifying the directory, you will refer to your own directory. You can 
reference files in some other directory simply by prefixing the directory name to the file name, as 
illustrated. 

When you put a file onto a file server, if there is already a file with the same name, the new file is 
added, with a version number one bigger than the old one. When you reference a file, you get the 
one with the largest version number if you don’t specify which one. As you can see, it is almost 
never necessary for you to specify a version number explicitly. 

There is a protection system, not described here, which allows you to control which other users can read or write your 
files. The usual setting of the protection, and the one you will get automatically if you don’t say anything special, allows 
all Xerox users to read the file, but prevents anyone except the owner from writing it. 

On IFS, but not on Maxc. files within a directory may be organized into sub-directories. For example, the file named 
<Jones>Memos>ActivityReport.bravo!3 

belongs in directory Jones, sub-directory Memos. You can have as many sub-directories as you wish within your own 
directory. You can even have sub-directories within sub-directories, to as many levels as you wish, subject to an overall 
limit of 99 characters in each file name. 

Most commands that accept a remote file name also permit you to type a file name pattern , much as 
does the Alto Executive (section 4.2). In this case, the command is repeated for all files that match 
the pattern. If the file server is an Ifs, the magic character (but not "#") may appear 
anywhere in the name, just as on the Alto; if the file server is Maxc, however, must appear in 
place of an entire field of the file name (directory, main name, extension, or version), and other 
uses of are not permitted. Thus, "‘.memo” and "<Jones>*.*" are legal file name patterns on 
both Maxc and Ifs, but *. BWI A is legal only on Ifs. Note that to refer to all versions of each file you 
must specify for the version field explicitly (that is, "!*" on IFS and on Maxc); otherwise, the pattern will 
match only one version (usually the highest-numbered). 


6.3 Transferring files 

You can transfer files between your Alto and a file server using Ftp, the File Transfer Program. 
This program has a fairly elaborate set of features, which are described fully in the Ftp Reference 
Manual found near the end of the Alto User’s Handbook. This section tells you enough about Ftp 
to take care of most ordinary needs. After you have become familiar with this material, you might 
skim over the Ftp manual once, just so that you are aware of the other facilities that are available. 

After starting Ftp, you will see three windows on the screen; from top to bottom, they are the 
server window, the user window, and the Chat window. Most interactions with Ftp involve only the 
middle window — note the blinking vertical bar there, which shows where you can type. The first 
step is to type the name of the machine you want to talk to. For example, if your file server is 
named Ivy, you should just type 



In a second or two you should get back a response like 


Ivy (Parc) file server 1.16 9-Apr-78 
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If the file server is not operating, there will be delay of about a minute before FTP gives up trying to contact if you 
can give up sooner by striking the blank key to the right of CR. 


Now you can retrieve a file from the file server, or store a file into it. To retrieve, you type 
* Ret rieve remote file Example as local file Example [New file] ^ 

As in the Executive, you can just type enough of the command to identify it uniquely, and then a 
space; unlike the Executive, FTP supplies the rest of the command name automatically. You then 
type the remote file name, followed by a space. If the file server has a file by that name on your 
e. If directory. Ftp will then suggest a local name for die file followed by "[Old file]" or "[New file]", 

can depending on whether or not the file already exists on your Alto disk. If you like the name, you 

, as can just type CR. Otherwise, you can type some other name, as in the following example; 

* Ret rieve remote file Example as local file Dummy [ New file] 

— ■ Note that the name originally suggested by Ftp will disappear as soon as you start to type the new 

one. If you decide you don’t want to retrieve the file after all, strike DEL to cancel the command. 
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After you type the terminating CR, Ftp will transfer a copy of the file from the file server to your 
Alto disk. During the transfer, the cursor will flip its two black squares back and forth every time 
it transfers a block of the file, so you can tell how fast it is progressing from the frequency of flips. 
When Ftp is done, it will tell you how long the file is, followed by "Done" and the prompt If 
you gave a file name pattern for the remote file. FTP will repeat the above procedure for each file that matches the 
pattern. You may strike DEL to skip over any files that you don’t want to retrieve. 

To store a file presently on your Alto disk onto the remote machine, you type 
*St ore local file Example as remote file Example CR 
or *St ore local file Example as remote file Pummy CR 

again depending on whether or not you want to use a different name. In this case, the message 
"[Old file]" or "[New file]" will not appear; remember, however, that storing a file on a file server 
ordinarily creates a new version rather than overwriting an existing file with the same name. The 
Store command does not accept file name patterns. 

If you were not logged in at the time you started FTP, you will be asked for your user name and 
password when you do the first Retrieve or Store. Ftp will save this information so that you won’t 
have to provide it again until the next time you boot the Alto. 
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You can do as many Retrieve and Store commands as you want When you are done, type 
*Q uit 

and you will be back talking to the Executive. 

If you intend to do a lot of transfers to of from a directory other than your own, you can say 
* Dir ectorv OtherPir CR 

to make <OtherDir> be the default directory for remote file names; this saves typing <OtherDir> in 

front of each name. Similarly, if you want to refer repeatedly to a sub-directory on an IFS file server you can say 
for example, 


ectory Jones>Memos ( ~' R 

Directory protections are ordinarily such that you cannot store into directories other than your own. 
mow the password of some directory. 


directory 


you 
OtherDir 


can connect 
Password xxi 


to it 
„CR 


by saying 


However, if you 


h f 01 ° n y r‘ rects FTP s altention directory (just as does the Directory command) but also gives you complete 

have ma ^ ,, y ° u * ere lts owner - -rhe Password is not displayed when you type it, of course. File servers generally 
Droiert n -rh S °r a ed ■’"dr only directories that don’t belong to any particular person but rather are for use by a group or 
into it 1116 L ° nneCt command is the way you gain access to such a directory, particularly when you want to store files 
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6.4 Listing and deleting files 

You can get a list of the remote files that match a file name pattern with the List command; for 
example, 

* List *.bravo CR 

or * List <Jones>Memos>* CR 

It is quite slow, however, and there is no way to interrupt it except to shift-swat out of Ftp. You 
are better advised to obtain such information using the Chat program, to be described shortly. 

To delete a remote file, type, for example, 

* Del ete Example CR 

After displaying the full name of the file, Ftp will ask you to confirm or cancel your intentions. If 
there are multiple versions of the same file, the lowest-numbered version will be deleted. 



6.5 Transferring files to and from another Alto 

In addition to accessing a file server, FYp can communicate with any other Alto that is also running 
Ftp. By this means, you can transfer files directly from one Alto disk to another. 

To do this, boot the disk and start up FYp on the second Alto. Suppose its name is Banjo. If you 
don’t know what its name is, you can use its network address, which FTP shows at the very top of 
the screen (e.g., "3#326#"). Now go to the first Alto, start up Ftp, and tell it to connect to the 
second Alto simply by typing its name (much as you would type the name of a file server); for 
example, 

* Banjo CR 

or * 3#326 # cr 

Now you may retrieve and store files as usual. Of course, in this case remote file names will not 
contain directories or versions (unless version numbering is enabled on the other Alto). Also, file name 
patterns will not be accepted in any context 

When you start FTP on an Alto, it is normally ready to act as a remote machine or server as just discussed. If you 
don’t say anything special, it will allow any other machine to retrieve Files, and to store new files, but not to overwrite 
existing files. You can change these defaults by starting FTP with 

> Ftp/x 

where x can be: (no server) to prevent any such transfers; Protected to allow retrieving only, but no writing; 

Overwrite to allow existing files to be overwritten. Any server activity is reported in the server window at the top of the 
screen. 


6.6 Access via Chat 

The File Transfer Protocol (the means by which FYp communicates with a file server) limits itself to 
the basic set of operations already described. There is an escape mechanism that lets you get at 
some important additional file server facilities directly, using a program called Chat. Chat uses the 
Alto display to simulate a traditional, "dumb” computer terminal, and thereby enables you to talk 
directly to Executive programs running in the file server machines themselves. 

Maxc, being a general-purpose time-sharing system, has a large array of commands and programs; 
only the ones directly concerned with Maxc’s role as a file server are described here (a few 
additional facilities are presented in section 6.8). The IP'S Executive's command repertoire is limited 
to operations on files. Most of the commands described here are the same on Irs and Maxc; 
however, there are a few differences which you should note carefully if you use both systems. 
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To initiate a conversation with the Executive in a file server named, say. Ivy, just type 
> Chat Ivy CR 

If all goes well, you will see the message "Connected to:" followed by some numbers at the top of 
the screen, a message from the server’s Executive immediately below that, and at the left 
margin prompting you for type-in. If Chat has trouble getting connected, it will tell you its 
problem after trying for a few seconds. This usually means that the server is broken; you might try 
again in a few minutes. 

Tire next step involves logging into the server Executive. Chat may do this for you automatically, 
depending on the version of Chat you are using and the file server you are accessing. In this case, if 
you have forgotten to Login to your Alto, Chat will first ask you for your account name and password. Otherwise, 
you must type 

© Login (user) name (password) passworcF R 

When the server types more than a screenful at you, it will pause after every screenful and "ring the 
bell", which causes Chat to display a large DING at the top of the screen. After you have had a 
chance to read the screen, striking any key on the keyboard will get the server to produce the next 
screenful. If you type ahead, this feature is suppressed. 

Whatever the server Executive is doing, you can force it to stop by typing C c . On Maxc, you may have 
to type Cf several rimes in quick succession to get it to stop. 

When you are finished talking to the server Executive, type 
@ Logout CR 

(or "Quit" if the server is an Ifs). This will terminate your Chat session and return control to your 
Own Alto’s Executive. If you are connected to Maxc, Chat won’t terminate until about two minutes after you log 
out: to give control back to the Alto Executive immediately, type SHIFT-SWAT. 

If the file server is an IFS, you will be logged out automatically if you don’t type anything for two 
minutes. This is because Ifs can service only a small number of users (currently five) at once; the 
automatic logout is intended to prevent Ifs from being tied up by users who aren’t doing anything 
useful. 

Chat keeps a record of your conversation on a file called Chat.scratchScripL You can read it with Bravo after a Chat 
session, just to see what happened, or perhaps to copy things out of it into other files, print it, or whatever. There are 
two funny things about this file which you need to know about: 

The file is not erased when you start a new conversation. Instead, the typescript of the new conversation starts 
at the beginning of the file and continues for as long as the conversation lasted. The end of the conversation is 
marked by the characters <=> after which you may see the remnants of previous conversations. 

The typescript file is only 20,000 characters long. If your conversation is longer than that, the typescript will 
wrap around to the beginning. It is possible to make the file larger by editing the [CHAT] section of the user 
profile (the file User.cm) in the obvious way. 

You can also initiate a Chat-like conversation with a file server while you arc running FTP. At the bottom of FTP’s 
screen is a "Chat window” (actually labelled "User Telnet"), in which you can talk directly with a file server's Executive 
in much the same manner as you do with Chat You can move the blinking cursor down into the Chat window by 
striking the unmarked key to the right of right-SHIFT; to get back to the middle window, strike the unmarked key to 
the right of RETURN. In the Chat window, after typing the server name followed by CR, you can log in and do 
whatever you want This window isn’t very large and doesn't offer all the conveniences of Chat itself, but at times it is 
nice to be able to switch very quickly between transferring files an d giv ing commands to the ser ver E xecutive. You can 
make the Chat window larger when you start up FTP by typing FTP/ — S , which prevents the FTP server from being 
started and thereby eliminates the upper (server) window. 




6.7 Server Executive commands 


i 


You type commands to Ifs and to Maxc in more-or-less the same way (except for those commands 
that have different names on the two systems); however, the responses from Ifs and Maxc are 
usually somewhat different. The examples below illustrate Ifs’s responses. You may type "?" at 
any point to obtain a brief explanation of what you are expected to type in next Maxc normally does 
not display the remainder of abbreviated commands or the explanatory text in parentheses; however, you can force it to 
do so by terminating fields you type in with ESC rather than space. 

To generate a list of the names of all your files, type 

on Ifs: @ List CR on Maxc: @ Pir CR 

To list only those files matching some file name pattern, say, "Activity.*”, type 
on Ifs: @ List (files) Activity.* CR on Maxc: @ Dir Activity.* CR 

To list another user’s directory, type 

on IFS: © List (files) <OtherUser>* CK on Maxc: @ Dir <OlherUser>*.* CR 

Caution: note carefully that the command names are different on Ifs and Maxc. Worse, there is 
also a List command on Maxc, but with an entirely different meaning (it causes hardcopy to be 
generated). Be careful! 

You can obtain more detailed information about your files (length, date written, etc.,) by typing a 
comma immediately before the CR; for example, 

on Ifs: © List (files) Activity.*, 01 on Maxc: @Dir Activity.*, 01 

At this point, the server Executive will type "@@" at the left margin and permit you to type in one 
or more sub-commands that modify the action of the main command; in the case of List and Dir, 
subcommands are used to specify what information you wish to see about the files. Some of these 
are: 

@@ Type CR 
@ @Size CR 
@ @Length CR 
@@ Creation CR 
@@Write^ 

@@ Read^ 

@@ Times CR 
@@ Author CR 
@ @Verbose CR 
@@ Everything CR 

After you have typed in one or more suo-commanas, type just CR in , __ 

prompt The server will now perform the main command and list out the files' with the information 
you requested. The columns of printout will be aligned correctly only if the font Chat is using is a fixed-width font 
such as Gachal2 or GachalO. 


file type and byte size 
size in pages 
length in bytes 
date of file creation 
date on which the file 
date on which the file 
times as well as dates 
name of user who created the file 
same as Type Size Write Read Author 
everything known about the file 
or more sub-commands, type just CR in response to the 


was 

was 


last 

last 


written 

read 


You can delete one or several files (or all files matching some file name pattern), just as on the 
Alto, with 


CR 


@ Delete filel ftle2 

On Ifs, the server Executive will now print out each file name and ask you to confirm your 
intention to delete it (type Yes or No); this is because once a file is deleted it is gone forever. On 
Maxc, all the files are deleted immediately without further confirmation; however, there is an 
Undelete command that you can use immediately afterward if you change your mind. 
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To delete all old versions of files (i.e., all but the highest-numbered version of each file), type 


on IFS: 


@ Delete *, CR 
@@ Keep 1 CR 


( note the comma j 


@@£R 
on Maxc: @ Pelver CR 

Delete oldest? Yes CR 
Delete 2nd newest? Yes CR 
File(s): ® 

It is a good idea to do this fairly frequently, since old versions of files can pile up and waste a lot 
of space. 


To find out how much space you are using on the file server, type 
@ PskStat CR 

One IFS or Maxc page is equivalent to about four Alto pages. You will notice that you also have a 
disk limit which is the maximum number of pages you are permitted to use on the file server at one 
time. If you exceed your disk limit, the server won’t let you store any more files until you first 
delete some existing ones to get you below your disk limit To get your limit changed, consult your 
local support staff. 

You can direct your attention to some other directory by typing 
© Connect (to directory) OtherDir (password) passworcP R 

just as in Ftp. You may omit the password when connecting back to your own directory, or when connecting to a 
directory belonging to a project of which you are a member. 

For the sake of security, it is a good idea to change your password occasionally (say, once a year). 
To do this, type 

@ Change Password (of directory) name (old password) xxx ( new password) yyy CR 

where name is your account name. The new password should be six or more characters long and 
unpronounceable (this is not enforced, however). Note that, contrary to normal practice, the new 
password does print out when you type it; this is so that if you make a typing mistake you will be 
able to see it. 


6.8 About Maxc 

Maxc’s Executive is thoroughly documented in its own manual, which was written primarily for 
programmers and contains a large amoup) of information not needed by casual users of Maxc. 
The next few paragraphs document Maxc facilities likely to be of interest to Alto non-programmers. 
If you don’t use Maxc you may skip this section. 

If you have a file on Maxc in Press format (see section 7.1 for an explanation of file formats), you 
can tell Maxc to print it directly by issuing the "Press" command. This is documented in section 
7.5. 

Maxc provides facilities for archiving files onto magnetic tape, where the cost of storing them is 
negligible. You can get an archived file back within one day. 

To archive one or several files, type 
@ Archive File filel file2 .. . CR 

(Note that the command name consists of the two words "Archive File"; after that you should type 
the names of the files you want to archive.) The files will be archived onto tape within a day or 
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two. After this has been done, they will be deleted from the disk automatically, and you will get a 
message notifying you that the archiving has been done. 

Maxc keeps track of your archived files in an archive directory which you can list exactly like your 
regular Maxc directory, using the Interrogate command rather than the Directory command; for 
example, 

© Interrogate *.bravo CR 

If the listing is of just one file, Maxc will ask you whether or not you want it retrieved from the 
tape. If you say Yes, the file will appear on your Maxc directory within a day, and you will get a 
message to that effect. It should be noted that the Interrogate command has some peculiarities not shared by other 
commands; in particular, you sometimes have to type an extra CR at the end of the command in order to get it to do 
anything. 

Because Maxc’s disk capacity is fairly small relative to the number of users who have Maxc 
accounts, the disk occasionally becomes full and it becomes necessary for a forced archive to be 
performed in order to make some space available. In a forced archive, all files that haven’t been 
referenced (retrieved, printed, or whatever) in the past 90 days are written onto tape and deleted. 
You will be notified when any of your files are archived for this reason, and the procedure for 
getting them back is the same as given above. 


| 

I 





Alto Non-programmer's Guide 


19 


'll get a 


7. Printing 


like your 
i id; for 


from the 
11 get a 

by other 
get it to do 


The subject of printing is somewhat complicated because of the large number of variables involved. 
Jo begin with, there are many different programs that you can use to prepare documents for 
printing Bravo Draw, Markup, Sil, etc. Then there are various file formats defining the 
representation of documents stored in files— Bravo-format, Press-format, plain text etc Finally 
there are several different types of printers— Dover, Sequoia, Slot/3100, Pimlico, etc. 

This section first presents some introductory information on programs, file formats, and printers, 
hollowing that are a few of the most common procedures for printing documents. 

7.1 Programs and file formats 
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Each of the programs you can use to prepare documents deals with information in a particular 
format. Bravo deals with text interspersed with special information about looks (fonts, paragraphs 
etc.), and document files written by Bravo’s Put command are in Bravo format, which only Bravo 
can read. The same can be said about Draw, Sil, and a number of other programs. 


In order to be pnnted, a document generally has to be in Press formal, which is a file format 
designed principally for representing printed pages. It follows that to print a document that is in 
some other format you must first convert it to Press format 

Programs that have their own special document formats also provide facilities for generating 
documents in Press format. For example, when you are using Bravo and you issue the Hardcopy 
command, Bravo first converts the document you are working on into Press format (this is why 
Hardcopy takes so long), then sends the resulting Press file to a printer. By using the File option of 
the Hardcopy command, you can tell Bravo to write the Press file on your disk rather than sending 
it to a printer. 6 



The important point is this: a given document can be represented in several different formats 
When you issue the Put command in Bravo you store the current document as a Bravo-format file 
but when you issue the Hardcopy command with the File option you store die same document as a 
Press- format file. But while these are two different representations of the same document, only the 
Bravo-format file can be read back into Bravo (using the Get command), and only the Press-format 
.le can be sent to a printer. You can’t read a Press file back into Bravo. This is why it is 
important to choose file names in such a way as to identify their formats— the extension Bravo to 
identify Bravo-format files, .Press for Press-format, .Draw for Draw-format, etc. 

There are a few programs that deal exclusively with Press files. Markup is an illustrator that can 
both read and write Press files. PressEdit is a program used to manipulate Press files in various 
ways, such as combining several small Press files to create a single large Press-format document. 

7.2 Printing servers 

To Print a document you send it through the network to a printing server, which is an Alto 
connected (usually) to some Xerographic printing device. The means by which you do this depend 
□otn on what kind of document you have and what type of printing server you are sending it to. 

There is a bewildering array of names you will hear associated with printing servers. These names 
an into three categories. There are family names that identify the type of printing device attached 
ro tne server Alto— a Dover is based on a Xerox 7000 copier, a Sequoia on a 3100, a Pimlico on a 
. ’ “cn there are names for different types of priming software used on the server Alto to 
rroi the printing device— Spruce and Press are the principal ones in use at present. Finally there 
e names identifying individual printing servers— the names by which you specify which particular 
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server is to print your documents. Examples of names of printing servers in Palo Alto are Clover, 
Menlo, Daisy, and Turkey. 

To complicate matters further, while every printing server accepts Press files to print, there are 
different kinds of Press files and not all printers are capable of printing every kind of Press file. A 
Press file can contain a wide variety of information: text, straight lines, smooth curves, raster- 
scanned images, and even color. Obviously, if you send a Press file containing color to a black-and- 
white printing server you will not obtain the results you might desire; but there are other 
restrictions as well, most arising from technical considerations that will not be discussed here. As a 
rule, however, most printing servers will attempt to print any Press file as best they can and will tell 
you about whatever difficulties they may have encountered. 

Here are some brief descriptions of the types of printing servers presently in use. 

Dover is the predominant work-horse printer. It is based on a Xerox 7000 copier and is capable of 
continuous high-volume output (one page per second). It is best at printing documents consisting 
primarily of text, though it has limited capabilities for printing simple illustrations such as those 
produced by Sil. More complicated graphics (e.g., curves produced by Draw or raster-scanned 
images produced by Markup) can only be printed crudely if at all. Also, Dover prints pictures 
containing large solid black areas very poorly. 

Sequoia is a smaller and slower printer, based on a Xerox 3100 copier. It can print more complex 
pictures than can Dover, and it prints solid black areas very well. 

Pimlico is a Xerox 6500-based color printer. TC-200 is based on a Xerox Telecopier. Versatec is an 
electrostatic printer, some models of which can print on very large sheets of paper. Slot/3100 is 
similar to Sequoia. All these printers are capable of printing any kind of Press file (with the 
exception, of course, that color information is ignored by black-and-white printers). 

Certain Press files contain copies of graphical information in two or more alternate forms. For example, curved lines 
produced by Draw are represented in the Press file both by mathematical descriptions and by Alto screen-resolution bit 
maps. Printing servers that understand the mathematical descriptions will use them to produce smooth curves, whereas 
servers that don’t understand the mathematical descriptions — principally Dover and Sequoia — will print the bit maps 
instead, producing rather crude curves. 

7.3 Fonts 

There is a large array of fonts available for printing text All fonts are named according to a 
standard convention: 

family-name point-size face 

The family-name describes the overall style of the font; e.g., TimesRoman or Helvetica. The point- 
size specifies the height of the font in points (one point is 1/72 inch). The face , if present, describes 
one or more additional properties of the font: B for bold, L for light, I for italic, C for condensed, 
and E for expanded. For example, HelveticalOB is a font in the Helvetica family, 10 points high, 
bold-face; TimcsRomanl2BI is TimesRoman, 12 points high, bold-face, italic. 

A Press file containing text includes the names of the fonts to be used to print the text, but does not 
include any information about what the characters actually look like. Rather, each printing server 
maintains the printing representation of the set of fonts used most commonly by users of that 
printer. Many servers have a limit on the number of different fonts they can keep (related to the 
size of the disk attached to the server Alto). If you try to print a Press file containing text in a font 
the printing server doesn’t know about, the server will substitute some other font and will tell you 
about this. 


Programs such as Bravo that format text according to how wide the individual characters are obtain 
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the necessary information from a standard widths file named Fonts.widths, which must be present 
on your Alto disk. Additionally, in order to display text on the Alto screen you must have the 
appropriate screen fonts contained in files named font-name. al. You can usually obtain these files 
from the <AltoFonts> directory in your file server. See section 4.6 of the Bravo manual for further 
information on how Bravo deals with fonts. 


Here are a few fonts that most printing servers know about. There are samples of some of them at 
the end of the Bravo manual. 


Family 

Point-sizes 

Faces 

(aside 

TimesRoman 

8, 10, 12 

B, 

I, 

BI 

Helvetica 

7, 8, 10, 12 

B, 

I, 

BI 


6, 18 

B 



Gacha 

8. 10, 12 

I 



Cream 

10, 12 

B, 

I, 

BI 

Math 

8, 10 




Hippo 

8, 10 




Arrows 

10 





You should consult your support staff to find out what fonts are available on your local printing 
servers. 
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7.4 Printing from your Alto 

After you first initialize your disk and before you attempt to print anything, you must edit your 
user profile (file User.cm) to declare the name of the printing server you intend to use regularly. 
See section 2.4 of the Bravo manual. All programs except Laurel that generate hardcopy look in 
User.cm to find out where to send Press files to be printed. For Laurel, you must also edit your 
Laurel profile, file Laurcl.profile, described in section 3.6 of the Laurel manual. 
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Generating hardcopy directly from Bravo is easy: you just issue Bravo’s Hardcopy command, 
described in section 2.4 of the Bravo manual. If instead of just printing hardcopy you wish to 
distribute a document on-line (say, by storing it on a file server so as to make it available to other 
Alto users), then rather than distributing the Bravo-format document you should make a Press- 
format file and distribute that. To do this, use the File option of the Hardcopy command and 
specify a file name with extension .Press. 

Once you have a Press file on your disk (having either created it yourself or retrieved it from a file 
server), you can send it to your printing server using the Empress program. If you just type 
> Empress filename CR 

one copy of the document will be printed by your default printing server. If you want more copies 
or you want to print on a different printing server, you can use the /C and /H switches’ for 
example, 

> Empress 3/C Menlo/H filename 01 

will cause three copies of the document to be printed by the printing server named Menlo. 

To print a file that is in some other format, say Draw or Sil, you must first create a Press-format 
version of that file. The means by which you do this are described in the appropriate manual, i.e., 
m the Draw manual for Draw-format files, the Sil manual for Sil-format files, etc. Once you have a 
Press file you can print it using Empress as just explained. 

There is an additional file format called plain-text. Basically it is a text file containing no font 
information and no formatting. You can create a plain-text file using Bravo if you start with an 
empty window and never type any CTRL-CRs or looks, but do type ordinary crs at the ends of lines. 
A non-programmer is unlikely to encounter plain-text files very often; but, for example, User.cm, 
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Laurel.profile, and Executive command files (see section 8.2) are plain-text files, as are 
documentation files with extension .tty that you obtain from a file server (section 9.2). 

You can print a plain-text file using Bravo Hardcopy, but there is an easier and much faster way: 
just type 

> F.m press filename CR 

Empress will discover that the file is plain-text rather than in Press format, and will convert it into 
Press format before transmitting it to the printing server. Empress will normally use a single font. Gacha8, 
for this purpose. You can change this to something else by editing the [HARDCOPY] section of User.cm to include a 
line such as 

FONT: TimcsRoman 10 B 

The foregoing procedures for sending Press files to printing servers apply to those printers that run in server mode, i.e., 
that wait for someone to send them a Press file over the network and automatically print any files they receive. There 
are some printers that do not operate in server mode, usually because they cannot safely be left to run unattended. To 
print a document on one of these printers, you have to go to that printer's Alto, use FTP to retrieve the Press file you 
want to print, and type 

> Press Print filename^ 

There are sometimes additional operating procedures which you will find posted near the printer. 

7.5 Printing from Maxc 

If you want to print a Press document or a plain-text file that is stored on Maxc, you can retrieve it 
to your Alto using Ftp and send it to your printing server using Empress, as already explained. 
However, you can alternatively tell Maxc to send the file directly to the printer. 

Before you do this, you must tell Maxc the name of your printing server. You do this by creating 
(with Bravo) a plain-text file containing the single statement 

PDEVICE served 

where server is the name of your printing server. Then Put onto file DocGen.prt, Quit, and use FTP 
to transfer DocGen.prt to your directory on Maxc. 

Whenever you want to print a document that is stored on Maxc, you should connect to Maxc’s 
server Executive using Chat and issue the command 

@ Press filename CR 

where filename is the name of a Press-format file (extension .press) or a plain-text file (e.g., 
extension .tty). You cannot use the Press command to print other kinds of files — in particular. 
Bravo-format files. 

If your DocGen.prt file on Maxc also contains the line 
REPORT Y™ 

then Maxc will attempt to notify you as soon as it has actually sent the file to the printer. Maxc will display a message 
on your screen if you are still connected to Maxc’s server Executive at the time; otherwise, it will send you a message 
that you will receive next time you run Laurel. 

7.6 PressEdit 

You can compose the various parts of a document with Bravo, Markup, Draw, Sil, or other 
programs that produce Press files, and then put together the complete document with a program 
called PressEdit You can also use PressEdit to extract pages from an existing Press file. PressEdit 
has some other features, some of which are documented here and the remaining ones in the Alto 
Subsystems manual. 
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The use of PressEdit for assembling documents has one major advantage: the resulting complete 
document can be left on a file server for printing by anyone who needs a copy. If you are 
producing a document for large-scale printing outside, on the other hand, it is probably easier to 
assemble it by hand than to go through all this ritual. One restriction you should be aware of is 
that every printing server has a limit on the size of Press file that it can handle (this is principally a 
function of the capacity of the disk connected to the server Alto). Most printing servers can handle 
Press files up to about 50 pages long (printed pages, not Alto disk pages), though some can handle 
documents substantially larger than that. If you have a very large document, you should distribute 
it as several Press files, each containing no more than 50 pages. 


The simplest use of PressEdit is to append together two or more smaller Press files to create a single 
large one. For example, 

> PressEdit Manual. press «- Chapterl .press Chapter2.press Chapter3.press CR 

creates Manual. press by concatenating the three other Press files in the order given. Be sure to type 
a space both before and after the You should also remember that the new Press file will 

occupy as much disk space as the three existing Press files combined; check that you have enough 
free disk pages before you start 



You can copy selected pages out of a Press file and put them into a new Press file by a command 
such as 

> PressEdit Short.press <- Long.press 3 6 10 to 14 18 to 22 CR 

This extracts pages 3, 6, 10 through 14, and 18 through 22 from Long.press and puts them in 
Short.press. Note that the numbers refer to consecutive pages in the source Press file, counting from 1, and have 
nothing to do with any page numbers that actually appear on the pages themselves. 

The concatenate and extract operations may be combined in one command to produce a document 
with pages from two or more source documents interleaved. This is particularly useful for inserting 
illustration pages into text documents. For example, 

> PrcssEdit Report.press «- Text.press 1 to 3 Figures.press 1 Text.press 4 to 8 Figures.press 2 
Text.press 9 to 14 CR 

This produces a document consisting of pages 1 through 14 of Text.press, with page 1 of 
Figures.press inserted between pages 3 and 4 of Text.press and page 2 of Figures.press between 
pages 8 and 9. 

If you want to make a document that has pages containing both text and illustrations, there are two 
ways to merge selected pages of different Press files. Both techniques are unfortunately rather 
cumbersome. The first method involves interleaving the pages of the text and illustration Press 
files, as just described, and then using Markup to copy material from one page to another in the 
resulting file. This procedure is documented in section 4 of the Markup manual. It is very slow 
and requires a lot of manual labor, and it does not always work for illustrations produced by any 
program besides Markup. 

The second technique requires you first to put special marks in the text and illustration Press files 
to show how you want the illustrations to be positioned. You then run PressEdit, which merges the 
source Press files automatically to produce the desired document 



Each illustration must be contained in a separate, one-page Press file. Somewhere in the illustration 
must appear an "arrow" consisting of the following piece of text: 

<==« 

There should be no spaces or other characters either before or within this piece of text; you must 
position the arrow using the text positioning facilities of the illustrator you are using. 



J: jl 

If '•t 


The main text document must also contain an arrow to show the position of every illustration 
Inside each arrow must appear the name of the Press file that contains the illustration to be inserted 
there; for example, 

< = = <Fig3.press< 

Again, there must be no spaces or other characters either before or within the arrow; you must 
position it by setting the left margin appropriately and possibly by using the vertical tab 
feature — see sections 3.2 and 3.6 of the Bravo manual. 

Having prepared all the Press files, you merge them by typing a command of the form 
> PressRdit/M Document.press <- Text.press Figl. press Fig2,press Fig3.press CR 

After the you must type the name of the main text file followed by the names of all the 
illustration files you are inserting into the final document. You may list die illustration files in any 
order, and if you are inserting a particular illustration into more than one place in the final 
document, you need type its name only once. 

Now, each time PressEdit encounters an arrow in the text document, it merges into that page the 
illustration contained in the Press file whose name is inside the arrow. PressEdit positions the 

illustration on the page by aligning the two arrows, then removes the arrows. 

PressEdit also has a facility for adding fonts to Press files. This is useful primarily when you want 
to edit the Press file with Markup and add text in some font that does not already appear in the 

file. For example, to add fonts Logo24 and Helvetical2 to file Example.press, type 

> PressEdit Example.press «- Example.press Logo24/F Helvetical2/F CR 

The next time you read Example.press into Markup, the new fonts will appear in Markup’s font 
menu in addition to the ones that were there before. 


8. Other things 

This section describes various facilities and procedures that you will probably find useful at some 
point Browse through them now just so you know where to find them. 

8.1 Copy and Rename 

To copy one file to another, say 

>Copy new <- olcf^ don’t leave out the spaces 

The <* is to remind you of the direction the copying is done. 


To change the name of a file, say 
>Rename new <- olep R 
>Rename old nevJ~^~ 


don’t leave out the spaces 


or: 


"Hiere must not already be a file called new. However, if old and new differ only in capitalization. Rename may 
be used to change the capitalization. 
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8.2 Command files 

Lm U in h tH 3 Scqucr \ ce r; of Executive commands that you wish to execute repeatedly, you may put 
them into a command file then invoke the command file at any later time. To create a command 
file, use Bravo to enter the exact commands that you would issue to the Executive then Put the 
document onto a file with the extension ".cm", the standard extension for command filS. 

To execute a command file named, say, Cleanup.cm, type 
> @Cleanup@ CR 

d ' Splay j he first command in the command file, perform the command, and then 
go on to the next command, continuing until it has executed all die commands in the file. To abort 

STS °[t^d?a n tely file ' *** ^ W '" ^ * * ** £nd ° f 016 CUrrent command ' or SHIFT-SWAT, which 

Actually, you may substitute the contents of a command file for any part of an Executive command 

Kh no' c» m af Md) yo“T,p C e 0 “ StS ° f “* ““ l " A ' Pha Bc “ Gam, ” a Delta " 

> Delete @ListOfFiles@ Epsilon CR 
the effect will be exactly the same as if you had typed 
> Delete Alpha Beta Gamma Delta Epsilon CR 

A number of commonly-used programs, most notably FTP, are capable of accepting their own 
Prp^imSy^by Spinf command line used t0 inv «ke them. Normally, when you start up 

> Ftp CR 

it^up^widi^say y ° U t0 tyPC commands t0 its own keyboard command interpreter. But if you start 

> Ftp Ivy Store/C Memol.bravo Report2.press CR 
Pip will make a connection to the Ivy file server, store the files Memol.bravo and Report2.press on 

woe in Vy vn ry ’ and retu ™ control to the Executive, with no further action on your part, except to 
type in your password if you haven t already logged in. V s p 

This capability may be used in conjunction with command files to permit you to deal with large 
rcnnrf S 1 “ 3t F ° r ““"P, 1 ®* if you have a set of Brav0 d ^mend comprising one Life 
issue ^the command tC 3 COmmand fie ’ say ’ Re P ort - cm > containing the names of those files, tfien 

> Ftp Ivy Store/C (QjReport.cmfQ) 01 . 
to transfer a complete, consistent set of those files to a file server. 

IsThafncS £ 3Wa f re i^fV* 6 la u n ^ ag< L USed t0 control Plp from the command line is not the same 
^that used to control it from the keyboard, though it is similar. You should read section 4 of the 
FTP manual before attempting to create Pip command lines. 


8.3 Dump files 

Sf P ^ CUtiV m D v mp C0I T and S‘ ves y° u a wa V to package up a number of files into a single, so- 
few m r? U c an 01611 trans P ort the dump file around as a unit, and later recover one, a 

consistent ^ iS CSpedally USeM 01 ”*«*** 
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To make a dump file, type 

> Dump Alpha.dm filel file2 ... 

Here "Alpha.dm" is the name of the dump file; by convention it has the extension "dm." You can 
list as many files as you want to be dumped. Often the * feature of the Executive is useful here, 
and of course you may obtain the list of files from a command file. 


To get files back from a dump file, type 
> Load/v Alpha.dm CR 

You will get a list of the files in Alpha.dm, and after each one you will be asked whether you want 
it loaded or not. If you leave out the /v all the files which don’t already exist will be loaded; if you 
say /c instead, all the files will be loaded whether or not they are already on your disk. 


The Ftp program has facilities for accessing dump files on a file server: you may transport a 
collection of files on your disk to or from a remote dump file without ever having to put the dump 
file on your disk. That is, the command 

> Ftp Ivy Dump/C Alpha.dm filel file2 ... ^ 

will package together files filel, file2, etc., and store them as Alpha.dm in the file server, not on your 
Alto disk. Similarly, 

> Ftp Ivv Load/C Alpha.dm CR 

will access Alpha.dm on Ivy and load the constituent files onto your Alto disk. You will probably 
find that this is more convenient than using the Executive’s Dump and Load commands. See 
sections 3 and 4 of the Ftp manual for complete information. 


8.4 Neptune and Dds 

The Neptune program provides convenient facilities for managing files on your Alto disk. Basically, 
it displays the names of all the files on your disk in a window that you can scroll just as in Bravo, 
and it permits you to specify operations on individual files simply by pointing at their names with 
the cursor. It can delete files, display the contents of text files, and (if your Alto has two disk 
drives) copy files from one disk to another. 

The Neptune manual is included at the end of the Alto User’s Handbook. If you read sections 1 
through 4 of that manual you will know enough to start using Neptune. 

There is another program called Dds which is considerably more powerful than Neptune and 
provides a number of useful capabilities that Neptune lacks. However, it is rather slow and takes 
up a great deal of space on your disk, so it is not included on the Basic Non-programmer’S 
Disk. You should try it out and see whether its features are valuable to you. The Dds manual 
appears as part of the Alto Subsystems manual (see section 9.2). 


8.5 Illustrators 

There are currently three major programs for drawing pictures on the Alto: 

Markup: good for pictures involving images, free-hand drawing or painting. Markup is 

also useful for adding pictures to a text document produced by Bravo; these 
pictures can come from Draw or Sil, or they can be drawn by Markup itself. 

Draw: good for pictures which contain lines, curves and text 
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Sil: 


good for forms and pictures with only horizontal and vertical lines, 
pictures it is much faster than either Markup or Draw. 


For such 


Manuals for Markup and Draw are included in later sections of the Alto User’s Handbook. Sil is 
also suitable for general use; unfortunately, the present Sil documentation is rather terse and is 
oriented principally toward users of the Design Automation system, of which Sil is a part You can 
obtain this documentation, such as it is, by printing <Sil>SilManual.press. 
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8.6 CopyDisk 

The simplest use of the CopyDisk program is copying the contents of one disk pack to another on 
an Alto equipped with two disk drives; it was described in section 2. CopyDisk can also copy the 
contents of a disk pack from one Alto to another over the Ethernet. To use it in this mode you 
need two Altos; in the example below they are called Banjo and Flash. 

Put the disk you want to copy from into one Alto (say. Banjo), and use the NetExec to invoke 
CopyDisk (see section 3.4). Put the disk you want to write onto into the other Alto (Flash), and 
start CopyDisk on that Alto also. You will type all commands on Flash, i.e., the Alto containing 
the disk you want to write onto. 

You should now go through the following dialogue: 

* Copy from: [Banjo]DP0 CR the digit zero, not the letter O 

Copy to: PP0 CR 

Copying onto DPO will destroy its old contents. 

Are you sure this is what you want to do? [Confirm] Yes 
Are you still sure? [Confirm] Yes 

In the above example, in response to "Copy from:" you type the name of the other Alto (the one 
you are copying from) in square brackets, followed immediately by "DPO" (with no intervening 
spaces). If you don’t know the name of that Alto, you can instead type its Ethernet address 
(displayed in the black bar on that Alto’s screen) followed by a #. In response to "Copy to:" you 
type simply "DPO", meaning the disk pack in drive 0 of the Alto on whose keyboard you are 
typing. 

After you have confirmed your intentions, the copy should proceed. When CopyDisk is done, if all 
went well you will see the message "Done. [Banjo]DP0 and DPO are identical" followed by the 
prompt You may now type Quit CR to each Alto. 

8 . 7 Version numbers 

• 

There is an optional version number facility that permits you to keep multiple versions of a 
particular file on your Alto disk without having to invent a different name for each one. This can 
be particularly valuable when you are making a number of successive changes to a document but 
want to keep earlier versions around in case you change your mind. Files stored on file servers 
always have version numbers, but use of version numbers on Alto disks is optional. 

Unfortunately, the version number capability has not been integrated fully into all Alto programs 
(in particular, the Laurel message system). Furthermore, the relatively small amount of storage 
available on an Alto disk makes wholesale maintenance of multiple versions impractical. For these 
reasons, the version number facility is disabled on the Basic Non-PROGRAMMER’S Disk. If you 
wish to use it, you may enable it by doing an Install, asking for the "long installation dialogue", and 
answering the questions appropriately. 
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If the version number facility is enabled, a file name may end with an exclamation point followed 
by a number: for example, "Alto.Manual!4" is version 4 of the file Alto.Manual. The basic rule for 
version numbers is this: 

When you read a file, you get the one with the largest version number (the current version), 
unless you include the version number you want in the file name. 

When you write onto a file for which the current version is n, a new version n+1 is created, 
and becomes the current version, unless you include the version number in the file name. 
Furthermore, if version n— 1 was around, it gets deleted, so that just two versions of the file 
are kept, the current one (with the largest version number) and the next earlier version. The 
number of versions kept may be changed at Install time. 

For example, if version 4 is the current version of the file Alto.Manual, there will probably be 
"Alto.Manual!4" and "Alto.Manual!3" around. If you write onto "Alto.Manual" (e.g. by doing a 
Put from Bravo), "AltoManual!3" will disappear, and "Alto.Manual!5" will appear with the new 
information on it. "Alto.Manual!4" will still be around unchanged, so you can get the old version 
back from there if you need it. On the other hand, if you write onto "Alto.Manual!4", that file will 
be changed, and no new versions will be created. 

If a file name doesn’t have a version number, most programs will not make any new versions, but 
will just write on the single version. Bravo is an exception; it always makes new versions if the 
version number facility is enabled. 


9. Software distribution and documentation 

Alto software and documentation are publicly available from file servers. Most file servers maintain 
duplicate copies of common files. In Palo Alto, most software and documentation of interest to 
non-programmers is stored on Maxc; in other places, on the local Ifs. You should consult your 
support staff for the exact maintenance policies used in your organization. 


9.1 Obtaining new software releases 

When new versions of the various programs are released, they are normally announced by messages 
to all registered Alto users. You can obtain a new version of a service called, say. Alpha as follows: 

If the release announcement includes instructions for installing the new version of the 
program, follow those instructions. Otherwise: 

Using Ftp, attempt to retrieve <Alto>Alpha.cm from your file server. If this succeeds, leave 
Ftp and type to the Executive 

>@Alpha.cm@ CR 

This will cause FTP to be invoked again, some files to be transferred from your file server, 
and perhaps some other activity. When everything settles down, you will have the new 
version. 

If there is no <Alto>Alpha.cm, retrieve <Alto>Alpha.run. This will be the new version of the 
program. You don’t have to do anything else. 

It is a good idea to keep fairly up-to-date. New versions of programs are sometimes released to fix 
serious bugs or to reflect important changes in operating procedures. If you run into trouble while 
running an obsolete version of some program, you are unlikely to receive much help or sympathy 
from the program’s maintainer or from your local support group. 
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The best way to obtain a complete set of new software, and clean up your disk at the same time, is 
to obtain a fresh disk, initialize it from the Basic Non-programmer'S Disk as described in section 
2, and then use Ftp to transfer all the files you want to keep from your old disk to the new one, as 
described in section 6.5. If you have an Alto with two disk drives, you can put the old disk in one drive and the 
new one in the other, then use Neptune to copy files between disks. See sections 1 through 4 of the Neptune manual. 
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An alternative way to make a Basic Non-PROGRAMMF.R'S Disk is to put the disk you want to 
initialize into an Alto, boot the NetExec as described in section 3.4, then type 

> NewOS CR 

You will get a fresh version of the operating system, which will ask you if you want to Install. Say 
Yes, ask for the "long installation dialogue", and say that you want to erase a disk. After a minute 
or so, you will have a clean disk with nothing on it except the Executive and FTP. Use FTP to 
retrieve the file <Alto>NewNpDisk.cm from your file server. Then type 

> @NewNpDisk CR 

This will automatically transfer all the needed files from the file server, and do any other necessary 
initialization. It takes about 20 minutes, and puts a significant load on the file server, so use this 
procedure only when you can’t find the Basic Non-programmer’S Disk. During the operation, 
there will be an automatic Install of the operating system; answer its questions appropriately. You 
will have to type your name and password at various points in the procedure. There will also be an 
automatic initialization of Bravo, and you should do a Quit when it is finished. 
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9.2 Documentation 

Documentation for all the standard Alto software can be found in the <AltoDocs> directory on 
Maxc and other file servers. As a rule, each major piece of documentation appears as a Press file 
which you can obtain and print by means of the procedures explained previously (section 7). Short 
documents are available as files with the extension "tty"; these are plain text files that you can 
transfer to your Alto and read with Bravo or print with Empress. 

To see what is available, you can Chat to your file server and type 
on Ifs: @List <AltoDocs>*.press <AltoDocs>*.tty 

on Maxc: @Dir <AltoDocs>*.press <AltoDocs>*.tty 

Here is a short guide to on-line documentation likely to be of interest to non-programmers but not 
already contained in the Alto User’s Handbook. All are stored on the <AltoDocs> directory except 
•where noted otherwise. 

Alto Subsystems, files Subsystemsl.press and Subsystems2.press. 

This manual, which is about 150 pages long, contains documentation for a large number of 
Alto programs. Included is comprehensive information on Chat, CopyDisk, Empress, and 
the Executive, which are only partially described in the Alto User’s Handbook. An 
additional program of interest to non-programmers is Dds, which enables you to display and 
manage your Alto disk’s file directory in ways much superior to Neptune. 

Alto Subsystems Catalog, files SubsystemsCatalog.press. 

This is a summary of Alto subsystems, organized by function. 



Sil Analyze, Gobble, Build Reference Manual, file <Sil>SilManual.press. 

Sil is an illustrator specialized for very rapid composition and editing of pictures consisting of 
straight lines and text. It is part of the Design Automation system for digital logic 
development, but Sil is useful in its own right as a general-purpose illustrator. 
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Printing at Palo Alio , file Printing.press. 

P ]S tj !L a ^"jP^ensive summary of Press printing facilities, formats, and programs. Despite 
its title, it is applicable more-or-less everywhere. 

How to Use Ifs , file <IFS>HowToUse.press. 

™ $ Ato “Sf H^k" Ual f ° r ,FS - PreSentine 3 f>ir am ” nt ° f “ 

The Alto User’s Primer , file AltoUsersPrimer.press. 

contains some introductory material on Alto hardware and software It is 

"h„ w w c T„ er gef r Who,e ai, ° w ° r ' 4 and iK ™ ^ * ■» 

Whole Alto World Newsletter. 

monthly newsletter that serves as a vehicle for communication of Alto-related 
! f ™ tlon among Alto users throughout Xerox. Each month’s edition is stored as 
WAWNewsm-yy.press; for example, WAWNews8-78.press is the August 1978 edition 
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Preface 

This manual describes the Bravo system for creating, reading and changing text documents on the 
Alto. It is supposed to be readable by people who do not have previous experience with computers. 
You should read the first four sections of the Non-Programmers Guide to the Alto before starting 
to read this manual. 

You will find that things are a lot clearer (I hope) if you try to learn by doing. Try out the things 
described here as you read. 

Material in small type, like this, deals with fine points and may be skipped on first, or even second, reading. 

This manual is written on the assumption that you have the user profile, fonts and other Bravo- 

related material from the Basic Non-programmer’S Disk. If this is not the case, some of the 

things which depend on that stuff will not work the same way. 

There is a one-page summary of Bravo at the end of this manual. It is intended as a memory- 
jogger, not as a complete specification of how all the commands work. 

Bravo was designed by Butler Lampson and Charles Simonyi, and implemented mainly by Tom 
Malloy, with substantial contributions from Carol Hankins, Greg Kusnick, Kate Rosenbloom and 
Bob Shur. 
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1. Introduction 

Brav ° ls the standan J Alto system for creating, editing and printing documents containing text It 

k "“ h “ “ h “ dle ■**“ “ forfhSVu' 

When you start up Bravo (do it now, by saying Bravo/e CR to the Executive), you will see two 

wlndom ° fi n / he T Cn ’ SCpa ? ted by a heavy horizontal bar. The top one contains three lines wkh 
some useful introductory information; it is called the system window. The bottom one contains a 
copy of the material you are reading, which was put there because of the ”/e" you typed to the 
If you had omitted the "/e", as you do when using Bravo normally, the bottom window 
the” h r C Cmpty - except for a sin 8 le triangular endmark which indicates the end of a document In 
the bar separating the two windows is the name of the document in the lower window. 

As you do things in Bravo, the first two lines of the system window will give you various useful 
°, f inf0 ™ atl0n ^ hlc h ma y help you to understand what is going on and to decide what you 

ld d< 0 n ' t xt T, Usual | Iy ’, th ? t0p me teIls you what you can d0 ncxt - and the second line tells you 
what you just did, and whether anything went wrong in doing it Make a habit of looking at these 
two lines while you are learning Bravo, and whenever you are unsure of what is happening. 

nm Tf W vn IS g ° m f ° n in n BraV0 ’ y ° u can st °P k and 8 et back to a neutral state by hitting the 
del key. You can leave Bravo and get back to the Executive by typing 

Quit^ 

WhlCh y °j 5 VP n ^ and CR ^ arc underlined in this example; the characters which are 
ot underlined are typed by Bravo. This convention is used throughout the manual. Notice that 
you only type the first character of the Quit command; this is true for all the Bravo commands. 

Each Bravo window (except the top one) contains a document which you can read and change 
Usually you read the document from a file when you start Bravo, and write it back onto a file after 
you have finished changing it. Later, you will find out how to do this (section 2.3). It is possible to 
have several windows, each containing a document; this too is explained later on (section 4.2). 

2™? controlled partly from the keyboard and partly from the mouse, the small white object with 

working f Utt ° nS WhlCh SltS t0 the nght of 1116 ke yboard. As you push the mouse around^n your 
working surface a cursor moves around on the screen. Pushing the mouse to the left moves the 

?™ r , t0 the iefl ’ Pushing the mouse up (away from you) moves the cursor up; and so forth You 
Should practice movmg the mouse around so that the cursor moves to various parts of ftiescreem 

The three buttons on the mouse are called red (the top or leftmost one, depending on what kind 
of mouse you have), yellow (the middle one) and BLUE (the bottom or rightmost one) They 

Don ’ t ^ push "any 3 button s G y e L * ^ 1116 CUrS ° r * 0n 1116 SCreen 311(1 what shape k ha *- 

Mouse lore: 

of >l your hand* 31 ^ m ° USe W ° rkS bCUer if y0U hold k so ^ k bears some of the weight 

If (he cursor doesn’t move smoothly when the mouse is moving, try turning the mouse 
upsKle down and spinning the ball in the middle with your finger until the cursor does move 
smoothly as the ball moves. If this doesn’t help, your mouse is broken; get ft Sed 

You can pick the mouse up and move it over on your work surface if you find that it isn’t 
positioned conveniently. For instance, if you find the mouse running into the keyboard 
when you try to move the cursor to the left edge of the screen, just pick the mouse up and 
set it down further to the nght. H 
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2. Basic features 


with Bravo. When' you*' have 'finished tofs 5 V ° U haVG t0 kn0W in order t0 do any useful work 
you need the information ** SeCtI ° n ’ y0U 0311 read *e other parts of the as 


21 Mov ‘ng around in a document 


S«e it i„ aPPMrS “ 8 S,™'"", 11 ” hea,y Wack bar - Notice 


“? “ Ndd “ <■« the c„™ r Changes a 

Will be moved to the top of the window Tr^V^ ^ifca/H ^ li™ 0pposite the® cursor 

y u. nus is called scrolling the document up. 


indicating that when you let the button go the top Ibe 0 n d, Wn ’ ° W 1112 arrOW points d «wn 
the cursor is. Try it. This operation takes a few sernnH the , sc ? en wil1 be moved down to where 
the document up and down until you feel comforobte wfrhTr u" 1 get j mpatienL Practice scrolling 
scrolling wi* RED and 


■appears when you scroll up. The reason^fofSis ulhal " s''’ w,ndow . but that more text 

needs space inside itself (in the Alto’s memorvl rn H,!nf r addl “ on t0 s P ace on the screen, Bravo 
has only a few characters, it doesn’t take ud m!t-h ? > y T S ° f text on 1116 scre en. When a line 
across the page, like the lines in this document ~ tern , a space ’ but when it runs all the wav 
out of internal space, it stops displaying text and 1eav« rh ° C of * nternal s P a ce. When Bravo runs 
that there is more text in the dSent H e rh J vnf . rest of the window blank. You can tell 
gCtS1 ° * e end it displays a triangular endmark as tL^ero'last^h" 8 1116 en< ^’ because when Bravo 
see the endmark at the bottom of the diS tLt ^ l 8 t0 , mark 010 end ' ^ you don’t 
document which isn’t being displayed. ^ y Can be Sure 11131 there is mor e text in the 


STSumb™ V°h “ir dian^ imo J stripfd' right “ d . down YELU>W <*= middle 

pitffijss.- s s sis t'Jxzr 

p‘ P ! topen ’ you Wl11 find yourself someplace m Shook Y I f the oS , Lhumbnai1 int o the book and 
be about in the middle. If it is all rhp tu. 000k - If the thumb is near the middle von will 

the bottom, you will be at^the ^nd^ 3t ^ t0P ’ y ° U Wl11 be at ^ begraning; if all thew^ajat 


book P You^wi U llso ^cc^a noth cr s triped* a rrow 3 enc lrf S" 8 k° ° f YELL0W is Iike Pipping open the 
>t points to your current locadon Ke document a!'" 3 box ’ ™ s °nc is called the lookmark- 
again without moving the mouse, the thumbnail and the hnnt et up YELLOW r if you hold it down 
a solid arrowhead; this happens because the thnmhino^f bo ° kmarlc should coincide exactly, making 
f h aC h mdlcated by the thumbnail. To move forward f litdf 1 ^ document exactly to the 

the bookmark and thumb again; to move backTufh ihl h P k ^ thumb nail down a little below 
To get to the beginning, push the thumbnail u’n^ntShS ^ mb " aiI , up a httle above the bookmark 
bar at ** t0 P of the window. Try thumbing voSLSh^K °y erlaps sli S h t]y the horizontal 
comfortabJe with it. Also try thumbing and dien Slfug ^p and Sown'” 1 Y ° U ^ 
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2.2 Changing the text 

In order to make a change in the text of your document, you have to: 
say where you want the change made, by making a selection; 
say what you want done, by giving a command. 

You always make the selection first, then give the command. If you change your mind about where 
you want the change made, you can always make another selection. Making a selection is just like 
pointing with a pencil: it doesn’t have any effect on the document. Only commands can change the 
document. You never have to worry about getting rid of a selection, since it never does any harm. 
If you make a selection, and then give a command that doesn’t require any selection, that is 
perfectly all right; the needless selection will be ignored. 

You make selections by pointing with the mouse and pushing one of the buttons. To try this out, 
move the cursor into the region of the screen where the text of the document is displayed. Notice 
that the cursor is displayed as an arrow which points up and slightly to the left. Point the arrow at 
a character (any character) in the document, and click RED. The character you pointed at should be 
underlined; if it is, you have just selected it. If it isn’t, look nearby and see if some other character is 
underlined. If you find one, then that is the one Bravo thought you were pointing at Experiment until you feel 
confident that you can point easily at characters. 

You should note that each selection erases the previous one; there is only one selection at a time, 
and it is the most recent one. Also, you can make a selection at any time, except when you are in 
the middle of a command. Once you have started a command, you must either finish it normally, 
or abort it by striking DEL, before you can make another selection. 

Something useful to know: if you hold RED down, you can move the cursor around and the 
selection will follow it The selection won’t freeze until you release RED (or move the cursor out of 
the text area). Try this too. 

Now try. a selection using YELLOW instead of RED. Notice that instead of underlining a character, 
Bravo now underlines a whole word. A word is defined as consecutive letters and digits, or 
consecutive punctuation characters. For convenience, apostrophe is counted as a letter. Also, a number containing 
a decimal point is a single word. 


There is one more thing to learn about selecting text: how to select more than one character or one 
word. To do this, first select a character with red. Then point to another character and click 
BLUE; Bravo will underline all the characters between the one you selected with RED and the one 
you pointed at with blue. This is called extending the selection. Try holding down BLUE and 
moving the cursor around. The selection will change continuously so that it includes the characters 
between the one you originally selected with red and the one you are pointing at now. As before, 
when you let up the button, the selection will freeze. You can change the extension as many times 
as you want by using blue over and over; Bravo will remember the original selection you made 
with red until you make another one. 

Finally, try selecting a word with YELLOW and then using blue to extend the selection. Notice that 
the end of the selection will be a word also. To select the entire document, issue the Everything 
command. ~ 

Space, tab and carriage return (CR) characters in the document simply appear as white space on the 
screen, just as they do on paper. You can, however, select them like any other characters. Try it 
You will notice that not all the white space on the screen can be selected; in fact, the space on a 
line after a CR, and the space to the left of the left margin, cannot be selected. Bravo’s handling of 
white space is discussed in detail in section 3.5. 



Now that you know how to say where you want a change made, it’s time to make a change. Select 
something (for instance, a word). Now type D (for Delete). The word you selected is deleted from 
the document, and the selection moves over to the character after the original selection. The rest of 
the text is adjusted to make up for the deleted material; if necessary some words may be brought 
up from the next line to fill up the one which contained the deleted material. 

You can undo the deleuon by typing U (for undo). Try it; you will see the stuff you deleted 
reappear, and it will be selected again, just as it was before you deleted it. Do several deletions, 
followed by undos, until you are sure you know what will happen. Try deleting larger pieces of 
text by extending your selections. Be sure not to move the selection between doing the Delete and 
the Undo. 

Delete and Undo are commands. Like all Bravo commands, they are given by typing just the first 
letter of the command name. You can type the letter in either upper or lower case. 

To add new text, select something in front of which you want the new text to go (if you want it to 
go at the very end of the document, you can select the cndmark). Then type I (for Insert) You 
will see that a blinking caret appears just before the selection. This marks the place where the new 
text will go. Anything you type will appear where the caret is, and as you type each character, the 
caret will move over to make room for it. Try typing a few characters, and notice that the rest of 
the text is automatically rearranged to make room for the new stuff. 

If you strike the wrong key while typing, you can erase the mistake by striking the BS key (on the 
right side of the keyboard). You can erase as many typed characters as you like using BS. You can 
also use A c (hold down the CTRL key and type A) to erase a character; it works just like BS, and may be more 
convenient to type with your left hand, if your right hand is on the mouse. To erase typing On a larger scale, 

you can use W c (hold down the Ctrl key and type W) to erase a word and its following spaces or 
punctuation characters. When you have typed as much as you care to, hit ESC to finish the insert 
Notice that the caret disappears, and that the inserted material is selected. You can undo the 
insertion with Undo. Then you can undo the undo and get the insertion back. Try it 

Sometimes it is more convenient to insert after a selection, rather than before. You can do this with 
the Append command (remember that you just type the A). Except for where the new material 
goes. Append is exactly like Insert. 

If you want to change one word into another, or correct a typo, you have to delete some text and 
insert other text in its place. This can be done by a Delete followed by an Insert, but it is more 
convenient to use the Replace command, which combines these two functions into one Replace 
can also be undone. 

Whenever Bravo first displays the blinking caret, you can insert a copy of some existing text rather 
than typing in new text. You do this by making another selection, called a copy selection , instead of 
typing. The copy selecdon is made exactly like an ordinary selection, and you can even use the 
scroll bar to move around in the document in order to find the text you want to copy. You can 
distinguish a copy selection from an ordinary one by its dotted underline, which contrasts with the 
solid underline of an ordinary selection. 


You can change your copy selection as many times as you like. When you are satisfied with it, type 
ESC, and a copy of the copy selection will be inserted in place of the blinking caret. You can’t do 
anything else while you are making a codv selection, excent tn srrnll thp 
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There is one more useful thing to know about insertion. If you just type an ESC for an insertion, 
without making a copy selection or typing anything else, a copy of the last thing you inserted or 
deleted will be inserted. This is called repeating or defaulting an insertion; it is very convenient for 
inserting the same thing in several places, e.g., a dollar sign in front of several numbers. It also 
gives you another way to move text: first delete it, and then insert it in its new place by selecting 
the new place and typing Insert followed by ESC . 

You now know all three ways of doing an insertion: typing the text, selecting some existing text to 
be copied, or defaulting the previous insertion by simply typing ESC. These three ways of inserting 
text can be used whenever a Bravo command needs some text. You will see many references to 
"inserting text" as you read on. 

Before going on to learn anything more about Bravo, you should practice the Delete, Insert, 
Append and Replace commands, and copy selections, until they are quite familiar. 


2.3 Filing a document 

Whether you use Bravo simply to read or browse through a document, or to create or change it, 
you will need to fetch the document from a file before starting, and to file it away again afterwards 
if you have changed it This section tells you how to do these things. 

To fetch a document from a file, give the Get command. You will see the blinking insertion caret 
appear in the heavy black bar above the window. Insert the text of the file name, usually by typing 
it in, and ending it with an ESC just as for any other insertion. The document will appear in the 
document window, and there will be a note in the system window telling you how long it is. A Get 
will erase the old contents of the window, if any. 

To file a document away, give the Put command, and type the file name as you did for Get If the 
name you want is already in the black bar, you can just type ESC to default the name. It is also 
possible to edit the file name in the black bar, exactly like an ordinary document Put always files 
away the entire document regardless of what the selection is; when it is done, you will see a note 
which tells you how long it is. Bravo turns most of the screen black while executing a Put; this makes the Put 
run faster. Do not be alarmed at this. 

Warning: If you make some changes to your document and then attempt to Quit from Bravo 
without having done a Put, Bravo will warn you that the document has not been filed and will ask 
you whether you still wish to Quit. If you want to save the document, strike del to cancel the Quit 
command, then file the document using Put If you want to quit without saving the document, type 
Yes. If you do this, you will lose any changes you have made to the document. If this does happen to 

you, read section 4.3 on replaying to see if you can still be saved. 

If you Get a document from a file and Put it back on the same file, Bravo will save the original on 
a backup file. Normally the backup file’s name will be the name of the original file followed by a 
"$". The backup file is sometimes useful if you discover that some of the changes you made are 
not to your liking after all. If you have enabled version numbers at Install time (not recommended), the backup 
file will be the old version of the file from which you did the Get, and Bravo will make a new version for the Put (see 

section 8.7 of the Alto Non-programmer's Guide for a discussion of file versions). 

You can do an "unformatted Get" with the Z c command (type instead of Get); this treats the formatting information 
at the end of each paragraph as ordinary text. The main use of Z c is for patching up a file which has been damaged by 
hardware failure or cosmic rays. In particular, if Bravo refuses to Get the file because "End of file not in Bravo 
format", you can usually correct the problem by doing an unformatted Get of the file, deleting the last line or two, and 
Putting it back. Then Quit, restart Bravo and try again to Get the file. 
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2.4 Hardcopy 


Printed copies of a document may be obtained using the Hardcopy command. Before using 
Hardcopy for the first time, you must tell Bravo the name of the printer you intend to use regularly, 
lo do this. Get the file User.cm. In that document, you will find an entry that looks like this: 
[hardcopy] 

PREFERREDFORMAT: PRESS 
PRESS: Name-of-your-Press-printer 

Replace the words Name-of-your-Press-printer" with the name of the printer you intend to use 
(every printer has a registered name such as Clover, Menlo, or Daisy). Then Put the document. 
Quit, and type Bravo/i CR to the Alto Executive. 

7 ° P rint ° nc c °P,y of to document you are editing, simply give the Hardcopy command followed 
by CR. this will print the entire document, regardless of what the selection is. While doing the 
hardcopy, Bravo displays in the cursor a count (modulo 10) of the number of pages it has 
processed; hardcopy takes about 8 seconds per full page, like this one. After sending the document 
to the printer, Bravo will report success. If there is. a problem, Bravo will leave a note in the system 
window. If the printer is not responding, Bravo will leave a note to that effect, and keep trying 
You can abort the Hardcopy by typing del, as always. 


The hardcopy may fail for several reasons. If there is an EFTP error, trying again will usually work. If the problem is 
* 3t * a character in your document which is in a font for which there is no printable representation, Bravo leaves 

tanks of the „ PUtS “ 3t t0p of 1116 screen - You can try- again after modifying the 

lnnw « h selected character. If you have a page with so many different fonts that it exceeds the capacity of the 
’ B 0 f 3 ^ 65 charactac of the page selected and at the top of the window. There is no remedy for this 

problem except to simplify the offending page. See section 4.6 for more information about fonts. 


You may want more than one copy of a document. The Hardcopy command has an option called 
Copies, which allows you to specify the number of copies you want; you type in the number and it 
will appear in the leftmost buffer in the system window, much like a file name. You must give the 
Copies option right after die Hardcopy command, every time you want more than one copy. 


If you compare the hardcopy of your document with Bravo’s display, you will see that although the 
text is identical, the hardcopy has more words on each line, so that the two versions look quite 
different. In order to see a nearly exact facsimile of the hardcopy on the screen you can give the 
command 6 


Look hardcopy (note the lower-case h) 

You are now in hardcopy mode on the screen. Until further instructed, Bravo will represent the 
panted version of your document as faithfully as it can, by positioning each character on the screen 
within one-half screen dot (about .007 inches) of its position in the final hardcopy. The screen 
representation is 10% larger than the printed one. To turn off the hardcopy simulation, type 
Look Hardcopy (note the upper-case H) 


You can edit normally in hardcopy mode. In fact, if your document contains tables whose 
appearance is critical to you, it is advisable to stay in this mode, because in the normal mode text 
will take up much more space on the screen than it will in the final hardcopy (if you have such tables, 
you should also read section 3.5 on white space and tabs). In hardcopy mode it is also possible to see exactly 
where lines will be broken, so that you can insert hyphens by hand if necessary. 

Bravo provides a number of facilities for controlling page formatting, which you can read about in 
section 3.6. 


The , Har , dcop { command has options for printing on the Diablo printer, and for producing a Press file which can be 
combined with drawings into a larger printable document, or sent to a file server for public distribution These are 
described in secuon 4.8. 


1 

j 
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2.5 Miscellaneous 

As you edit, Bravo keeps track of the changes you make to the document. In doing this Bravo 

av^hio S Q SPaCC In A J t0 me ™ ry - D “ rin g a '°ng editing session, it is possible to consume all the 
available space, in which case Bravo will leave a warning note ("Core storage getting low") in the 
system window, and will refuse to execute any more editing commands. If this happens you should 
P ! y0 f Ur d °cument onto a file immediately, and then Quit, restart Bravo, and Get the document 
back from the file. Now you can continue with another editing session. 

When you have finished editing one document and have filed it away, you can Get another file 
and continue working. It you are making extensive changes, however, it is better to Quit and restart 
Bravo when you start to work on a new document. If you do this, you are less likely to provoke a 
bug in Bravo, and you will be able to recover from a crash with the replay feature (section 4.3) 
iriucn more QuicKly. 

The maximum size of a Bravo document is 65,536 characters. Whenever Bravo Gets or Puts a 
document it leaves a note telling you how long the document was. When your document has 
vnnAfm’i 6 characters, you won’t be able to add any more text, and peculiar things may occur if 
you do try to add more text. It is a good idea to split the document into two parts well before this 
nappens. To encourage you to do this, Bravo will flash the screen and display a warning message after even- 
command if the length of the document exceeds 60,000 characters. ^ 

If you type a character which has no printable representation, Bravo will display it as a black 
rectangle. The best thing to do with such a character is to delete it. 

Depending on exactly what Bravo is doing, the amount of text it can display on the screen will vary 

l™ can a W f t yS ,i gel thC maxin ? um of text displayed by doing a scrolling operation; if you 

scroll up with the cursor at the top of the scroll bar, the text won’t move, and Bravo will just 
display as much more as it can. If you then give a command, some of the text may disappear from 
the screen, but you can always get it to reappear by doing another scrolling operation. 

Bravo keeps copies within itself of information in your user profile (file User.cm; see section 4 6) 
and in various files on your disk; font files (named *.al and Fonts. Widths), and the files containing 
the Bravo system and its temporary storage (named Bravo.*). It refreshes these copies whenever 
you start it up with 

> Bravo/i CR 

This is called initializing Bravo. It is necessary to initialize whenever you get a new version of 
It ™y° ? r Alto Operating System and when you change your user profile or any font file. 

. Initializing is just like starting Bravo up normally, except that it takes about a minute. If you are in 
any doubt about whether something has changed since the last time you initialized Bravo or if your 

surfing 5 it r w?th 8 BraTO/T 0553865 Wh ‘ Ch refer ' t0 d ‘ Sk ° r file erTors > you should inilialize Bravo by 
You now know enough to edit unformatted documents. Take a rest 
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3. Formatting 


This section describes the Bravo facilities for creating formatted text and pages 
interested in formatting, you don’t have to read it. If you are interested, be fure 
3.3 and 3.4, where you will find a lot of good advice. 


It you are not 
to read sections 


Bravo normally describes character sizes and distances on the page in points. A point is a unit of 
distance used in the printing industry; there arc 72 points per inch. Thus 36 points is 1/2 inch and 

dlcTed V'LSZ 3.2. many y0 “ alS0 ^ d ' s ““ s 


i I! 


it 




3.1 Making pretty characters 


Bravo allows you to say how you want your text printed: in 
various sizes and type styles, superscripted or subscripted etc 
text is printed, or you can say how you want the characters to 
We will begin by describing how to change the looks of 


italics or bold face, underlined, in 
You can change the way existing 
appear as you are typing them in. 
existing text 


First, select the text you want to mess with. Then give the Look command. This command has a 
IdditioS SfomaCm’ by 3 S ’ ngle Char3Cter ’ Which is sometimes foI1 °wed by some 


bold 

italic 

^ to underline 

to subscript (text down 4 pts) 

SHIFT or t to superscript (up 4 pts) 

0 to 9 to set the typeface 

visible to display spaces, tabs, and CRs 

Down followed by a distance (see below) to 
move the text down that distance, relative to 
the baseline. Subscript is Down 4. 


SHIFT B to un-bold 

SHIFT I to un-italicize 

SHIFT - to remove the underline 

Down 0 esc to remove subscript or 
superscript 

shift V to stop this. 

Up followed by a distance to move the 
text up. Superscript is Up 4. 


cyt (the blank key to the right of BS on an Alto-I, or the key labelled BW on an Alto-ID to 
restore the standard looks: font 0; not bold, italic, underlined; visible, graphic, up or dowa 

dTfi»rln P t e m Ce t k ca l led , the f° nU For Brav0 > each different size of the same style is 

different font, but bold and italic are considered to be in the same font. The choice of fonts i 

specified by your user profile in a way which is described later (in section 4.6) but the standarc 
choice provided on the basic non-programmer’s disk ’ stanaarc 


0 

1 


is: 


This is the standard font 


Times Roman, 10 pt. 

Times Roman, 8 pt. 

XEROX logo (only the capital letters E O R and X) 

m ° f rna , thcmatical symbols. No bold or italics on hardcopy. 
Creek, 10 pt. No bold or italics on hardcopy. 

Times Roman, 12 pt. 

Helvetica, 10 pt. 

Helvetica, 8 pt 

Gacha, 10 pt This is a fixed-pitch font 
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9 Helvetica, 18 pt. The bold-face version of this font is especially good for making view- 
graphs. 
lOt 

ons You will find tables at the end of this manual which give the correspondence between ordinary 

characters and the Math and Greek fonts, and some samples of the various fonts. 


of 
-nd 
s, as 


in 
-ng 
i in. 


There is another Look option which is very convenient. It is Look Same, followed by a copy 

selection. In this case, what is copied is the looks, rather than the characters. This is the way to 

get one piece of text to print in the same style as another piece. 

Like most commands, Look can be repeated with ESC. This is useful if you want to change the 
looks of several pieces of text in the same way. You can also undo a Look with Undo. 

You can find out what the looks of a character are by selecting it and giving the Look ? command 
Bravo will tell you (in the system window) all the looks of the selected character. You may have to 

scroll the system window up in order to see all the looks. 


Looks during typing 


mj 3 

ome 


a 

s is 
lard 


Hjyjr 

fife. 



When you start typing, the looks which will be attached to the characters you type are set to the 
looks of 

the first character of the selection if the command is Insert or Replace; 
the last character of the selection if the command is Append; 
the standard looks otherwise. 

To change the looks while you are typing text, use the CTRL key instead of the Look command: 
hold down CTRL and type the look you want The only things described above which you can’t do 
this way are Look Up and Down; you can get the standard superscript and substript offsets with t 
and though. To restore the standard looks, you can just strike the CLR key; it is not necessary to 
use CTRL in this case. 


3.2 Paragraphs 

In addition to changing the looks of the characters, you can also change the shape of the text: the 
margins, space between lines, justification, centering, etc. 1’he Bravo facilities for doing this are 
based on the idea of a paragraph. 

A paragraph in Bravo is all the text between two CTRL-CR characters. You can tell when you have 
one by selecting it. To do this, move the cufsor into the line bar , which is between the scroll bar 
on the far left, and the text area. You can tell that you are in the line bar, because the cursor will 
appear as a rightward-pointing arrow. Once you are in the line bar, use the YELLOW button to 
select a paragraph. Note that the cursor changes to a paragraph symbol; it keeps this shape as long 
as the selection is a paragraph. 


The CTRL-CR that ends a paragraph carries the paragraph looks described below. It can also carry character looks and 
if you are setting up a standard paragraph, it is a good idea to attach to its CTRL-CR the character looks which you 
want as the standard ones for the paragraph. Thus, Tor example, the CTRL-CR for a standard heading like the one at 
the start of this section would carry the italic look. Of course, this is just a convenience, and not essential; you can 
always set the character looks during typein as described above, e.g. by typing ic for italics. 


If the text at the end of a paragraph is in a font smaller than the standard one, as this one is, the CTRL-CR ending the 
paragraph should carry the same font looks. Otherwise, the inter-line spacing of the paragraph may appear uneven. 
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The YELLOW button selects exactly one paragraph, so by looking at what is underlined you can tell 
where the paragraph starts and ends. Note that the second CTRL-CR (the one that ends the 
paragraph) is counted as part of the paragraph; the first CTRL-CR is part of the previous paragraph. 
You can use BLUE to extend the selection to several paragraphs. 


To merge two paragraphs into one, just delete the CTRL-CR that separates them. You will probably 
want to replace it with a couple of spaces, or maybe with an ordinary CR. To break one paragraph 
into two, insert a ctrl-cr; it is just like any other character, except that you can’t backspace over it 

If you select a paragraph and then give an Append, Insert or Replace command, a blank paragraph 
with the same looks as the selected one will be created for you to type into. 

To change the looks of a paragraph, you can use some more sub-cases of the Look command 
Select the paragraph (or any text in it) first, and then say Look, followed by: 

center; turns off justification 

justify (even right margin); turns off centering 

nested to indent the whole paragraph (36 pts, 
or 1/2 inch, more) 

open up more white space in front of the 
paragraph (12 pts, or 1/6 inch, more) 

g to open up half as much more white space in 
front of the paragraph as Open does (6 pts more) 

All of these can be invoked during type-in; hold down the CTRL key and strike the appropriate kev 
just as you do for character looks. 


SHIFT C to stop centering 
SHIFT J to stop justifying 
shift N to un-indent 

shift O to close up the white space 

SHIFT Q to close up the white space 


I 

I 


I 


h 

1 I 
! I 


In the following Look cases, d is a distance on the page, which can be specified in several different 
ways as described below. Distances are measured from the left edge of the paper (except for Up 
and Down, which measure from the baseline of the line of text). These looks cannot be used 
during type-in. 

Left d to set the left margin. The default is 85 points, or about 1.2 inches from the left edge 
of the paper. 

First d to set the left margin of the first line. Use this to control indenting or un-indenting 

Of the first line. A Look Left cancels a Look First, since it sets the left margin for all the lines of the 
paragraph. 

Paragraph d to set the left margin of all the lines except the first. A Look Left cancels a Look 
Paragraph, since it sets the left margin for all the lines of the paragraph. 

Right d to set the right margin. The default is 527 points. Since an 8.5" x 11" page is 612 
points wide, this results in 85 points, or 1.18", of white space on the right. Thus, the default 
margins center the text on the page. 

X n to set the space or leading between lines. The leading should be at least 1 point (as it is 
in this document) to avoid a squashed effect. If you want a less dense appearance, try larger 
leadings. The default is 6pt, which gives double spaced text 

Y n to set the leading in front of the paragraph. The default is 12pt, which gives a blank 
line between paragraphs. Look open increases the paragraph leading by 12 pts, and Look q 
increases it by half that, or 6 pts. On hardcopy, both line and paragraph leading are 
suppressed for the first line of a page or column. Leading must be less than 64 points. 

Here are the ways to specify the distance. Try them out until you are quite comfortable with them. 
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of the following forms: 

a distance in points. A point is a printer’s unit equal to 
1/72 of an inch. A number without a decimal point and 
with no explicit units is assumed to be in points. 

a distance in inches. A number with a decimal point and 
no explicit units is assumed to be in inches. 

a distance in centimeters. 

a distance equal to the width of that many blanks. 

By typing a number n, as above, preceded by + or -. The distance specified by n is added 
to, or subtracted from, the current value of the look being changed. Thus, to indent a 
paragraph by an additional one-half inch, type Look Left +^5 esc. 

By using blue to point to a place on the screen. The horizontal position of the place you 
point at is displayed in the system window. If you hold down BLUE and move around, the 
displayed position is updated continuously. 

By using red to select a character. The horizontal position of the left edge of the character 
is displayed in the system window. 

By typing \ (back-slash, not /), which displays a default value for the look being changed in 
the system window. 

By just typing ESC, which uses the value already in the leftmost buffer of the system window. 

You can select, point or default as many times as you want, just as with an ordinary copy selection 
Then you can type a number, if you like. When the leftmost buffer in the system window has the 
value you want, type ESC to complete the command. Of course, if you get disgusted you can always 
type DEL to cancel the whole thing. Note that pointing is a convenient way to measure horizontal 
positions on the page. 

Look All, followed by a copy selection, will copy all the paragraph looks of the paragraph in which 
the copy selection is made, to the paragraph containing the current selection. Note that Look All copies 
paragraph looks whereas Look Same copies character looks. 

If a paragraph is selected (using yellow in the line bar; the cursor will be a paragraph symbol 
when a paragraph is selected), the Look ? command will display the paragraph looks in the system 
window; if the selection is not a paragraph, the command displays character looks, as described in 
the previous section. You may have to scroll the system window to see all the information. Note 
that it appears in a buffer (see section 4.5) which is made current, and you can insert it into a document with a default 


If you have a paragraph whose left margin is less than the default (normally 85 pts). any characters in the paragraph to 
the left of the default margin will fall off the left edge of the window and will not be displayed. Try setting a left 
margin to some values less than 85, and see how this works. You can change the setting of the left edge of the window 
so as to make these characters visible on the screen, with the command 

Window Erlge d d\s a distance, which must be typed in and cannot be obtained by pointing. 

The distance d is the distance from the left edge of the page at which the left edge of the window should be set It 
snould be smaller than -any paragraph left margin if you want to see all the characters on the left For instance if d is 
u, the window edge will be at the paper edge; if the text has the usual 85 pt margin, this will result in 12" of white 
space in the window (in addition, of course, to the white space in the line and scroll bars). The default value for d is 
tne default left margin. 


By typing a number in one 
123 or 123pt 

1.71, 1.71in or 1.71" 
4.34cm 

a sequence of blanks 



Hints 


You can select several paragraphs (using blue to extend vour selection) and apply the same Look 
command to all of them. You can change the looks of e^ery paragraph in the doLment bv 

te y ofle%o^ Ct + the Wh ° ,e d r mCnt bef0r£ thc 1 °" k - A Look com“to?vf n 7a 

distance of the forni + n or -n adds or subtracts n from thc look value for each selected 
paragraph. Thus, Look Left +5 ESC will indent each selected paragraph by five more points. 

y °r S c e sevcra] different formats (e.g., for section headings or for indented material) vou can 
Jhe formatting from an existing example of a particular style to a newly created one with Look 
All Often it is convenient to put a set of sample paragraphs at the head of your document each 
containing one line which explains what it is a sample of. Then you can split to? 2. S 
described in section 4.2) and have the samples readily available to copy from with Look Air This 
15 hlghly P referab,e t0 en *nng all the new looks manually every tinufyou switch to a new fomat 

An alternative technique for creating a new paragraph in a specific style is to select the paraeranh 
before or after the point at which the new paragraph is to appear, then Append or Insert and make 
a copy selection of the desired sample paragraph. Now select the text of the newly-created 
'*/“*"* i he CTRL-CR a , the end, and Replace it with new ttltyouten 
71ns method copies both character looks and paragraph looks from the sample paragraph 

t re r hp tUn8 a UP ^ forn ? t f ? r a document - you should put a few blank paragraphs (just 
CTRL-CRs) at the end, and set the formatting on all of them to vour standard fnZ L 

format') ,en ™s d mSft bi ' the - formatti "g from a Paragraph which already has your standard 

, 11118 might ‘"olude indenting the first line of a paragraph, setting the leading leaving 
space between paragraphs, justification, and even the font. Now when you add material to the 

fom^tfing b vn>? S h rtinS mt0 one . of these bIank Paragraphs, you will automatically pick up all of the 
g you have preset. As you type along, each time you use a ctrl-cr to start a new 
paragraph, it will acquire the same formatting as the old one. 

3.3 Formatting style 

TTiis section is intended to provide you with some guidance in using all the different wavs Bravo 
you f° r contr olling the appearance of your document. Many of the rules are based on the 
customs of the printing industry. There are two advantages to following these customs: 

m re ! Ult °f ™ any years of experimentation, during which many people have tried 

to find out what looks good on the page; v v 

readers are accustomed to seeing text presented in this style. 

* lU " otice * at some of ^e ro'es are contrary to the usual practice for preparing documents on 
ypewnter. There are good reasons for this: when you are printing with variable-oitch fonts 

for ''fix ed-p heft prcc , isely conlro ] Ied ,cadin S- some of die things which wor/well 

ior nxea pitch, single- font documents are no longer appropriate. 

Emphasis 

Use italics for emphasis in text. You can also use boldface, but this is usually less desirable and it 

18 b Q ttCr t0 v SerV u b °’ dface for words which play some special role, e.g., begin and end in computer 

programs. You should also use italics for the names of variables, e.g., "Suppose there are n items." 

?n°Heri USe und< l rlini " g for em P hasis; * is not compatible with the use of italics and boldface Use 

^ser ynes 8 from ZT 3 di J? rcnt kind ° f emphasis ' e - g - t0 distinguish the characters a 

user types from the ones the machine types, as is done in this document. 
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Don’t capitalize a whole word for emphasis. In fact, try not to capitalize a whole word at all; it 
usually looks terrible in a variable-pitch font because the capital letters are so much wider than the 
small ones. If you have words which you think should be set in capitals for some reason, try 
Small Capitals. In this example, the S and C were 10 point (font 0), the rest of the letters 8 
point (font 1). Compare this with the appearance of FULLY CAPITALIZED words and you will 
see the point 


Section Headings 

In general, use left-justified rather than centered headings, and don’t use all capitals, for the reasons 
just discussed. Here is a satisfactory list of styles for the headings of successively larger portions of 
your document: 



smallest 

Italic 

18 pt paragraph leading (Look Y 18, or Look q if 
your standard leading is 12 pts). 

next 

Bold 

24 pt paragraph leading (Look Y 24, or Look o if 
your standard leading is 12 pts). 

largest 

12 pt bold 

36 pt paragraph leading (Look Y 36, or Look o 
twice if your standard leading is 12 pts). 


Note that you can switch from the standard leading to the 1.5, 2 or 3 times standard leadings for 
headings during typein, using (f and g^. For the largest units, you can center the heading and/or 
use all caps instead of, or as well as, switching to a 12 pt font. It is best not to have more than 
three levels of heading, but you can extend to four or five levels using these tricks. Helvetica 18 
bold (font 9 bold) is sometimes nice for chapter or document titles. 

Use Look Keep 80 (see section 3.6) on headings to make sure that the heading doesn’t end up all 
by itself at the bottom of a page. 

Leading 

The standard printing fonts are designed in such a way that they need some extra space between 
the lines to avoid a cramped appearance. You put this space in with Look X, and you should use 1 
pt for ordinary single-spaced text. If you want a less dense appearance, experiment with more 
leading. For double-spacing of the text, try Look X 6 (the default). 

Use double spacing (Look o) between paragraphs. When you have indented material which is fairly 
short, try 6 pt leading (Look q), as in the example two paragraphs back. Don’t use extra carriage 
returns to get blank space between paragraphs. However, the maximum leading you can specify is 
63 points; if you need more (e.g., to leave space for a figure) you will have to put in blank 
paragraphs. 

• 

Note that both line and paragraph leading are suppressed for the first line of a page or column. The height of a line of 
text (in points) is equal to the point size of the largest font used in the line, provided there are no characters which have 
been superscripted, subscripted or offset with Look Up or Look Down. If any character in the line is ofTset Up, the 
minimum line height, including leading, is given by the font size of the character, plus its ofTset: i.e., characters offset Up 
are allowed to eat into the leading. If a character is offset Down, the largest such offset must be added to obtain the 
line height: i.e., characters offset Down are not allowed to eat into the leading. 
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Indenting 

Use Look nested to indent material, and Look Nested to cancel the indentation Note that this also 
works when you are typing in. For example, if you type 

CR C n C Here are three points: CR c n c First ..CR c Second ..CR^Third ..CR'tt'Now we continue . 
the document will look like this: 

Here are three points: 

First .. 

Second .. 

Third .. 

Now we continue .. 

Flrst , if . you want to indent the first line of a paragraph, rather than tabs. When you have 
numbed For' “ "'" nden ‘ “* f “ line by aboul 15 P B «[’»•»'> if fce items are 

L jssrs* „ w u7 !rr?«r Look uft i2 °' ^ Fint - is - * brt “ ■» ^ «* 

1 2 f mb stopT^^pofm' (« ‘^oVlS 01 “* “ S " b “‘ ,uen ‘ 

1 V y t0 S ? ecify the p° siti0n Of the tab stop is to select the first character of 

the second line, using red. In this case, of course, the stop is at 120. 

4 r S0 T timeS !°° k better bala nced if the right margin is indented as 

well. Unfortunately Look nested doesn t do this for you; you have to change the right 
margin yourself using Look Right d. K g 

Offsets up and down 

Use the smallest offset you can get away with for subscripts and superscripts, since large offsets 
result in wide ugly spaces between the lines. The offset used by Look t (superscript) and Look <- 
(subscript) are defined in your user profile (see section 4.6); the standard profile sets it to 4 pts. 

3.4 Forms 

hi? V0 7'!J le ,7u U begi " 7 th a completely empty window and start typing into it, this is a 

whlh - f 7 should be av oided. Instead, you should start out by Getting a template or form 
Which will guide you in constructing the document you want. template or jorm 

eXa xT ple is a m u emo form ’ and y° u will fmd one on the file Form.Memo. Start Bravo 
a " d Ft* F ? 77° T t0 1110 window - You wiH see that it has spaces for the sender receiver date 
toe th h th F C t S h are flIk , d in ^ lth WOrds which indicate what shouId go diere. To fill in 

Se MFMOiinnY Whf W ° r ?’ and Re P lace k with the P ro P er text - Then d « the same with 
cnit a hiA M0Ii0DY ‘ • Wben y » are done ’ you have 3 completed memo which you can file under a 

form b il?r ie The n h S f >? Ut ‘ ? CarC ?‘ n0t t0 . Put thc docu ment back onto the file from which the 
forni came. The best way to avoid doing this is to edit the file name in the black bar above the 
document immediately after Getting the form. 

Your disk comes equipped with a few forms; you can see their names by typing form, tab to the 
Executive. You should construct your own forms for other kinds of documents whidTyou find 
yourself creating frequently. As you have seen in the description of Bravo’s foJatungTatures 
mied in 3 f vT Ca -ii F 0n j ai !? 3 great deal of m formation in addition to standard text and spaces to be 
ff W1 fmd that . y ° ur J lfe 1S casier and your wor k more uniform and of higher quality 

you use forms consistently, and take the trouble to carefully design a new one when necessary. 
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3.5 While space and labs 

When you type on a typewriter, you can get white space to appear between characters by typing 
spaces or tabs. You can get blank lines by typing carriage returns. In Bravo, you can do exactly 
the same things, with exactly the same results. Space, tab and CR are characters which are in your 
document exactly like "a", "b" or "c". You can get Bravo to display them as special, visible 
characters by selecting' the text in which you want to see them, and typing 

Look visible (this must be a lower-case v). 

To turn off the display and just see the usual white space, type 

Look Visible (this must be an upper-case V). 

Normally you don’t have to type any CRs; Bravo will automatically end a line when there is no 
room for the next word. You can force a line to end by putting in a CR; this is appropriate when 

you want to control the layout of the text precisely, as in a table. Otherwise, don’t put in CRs. You 

should use ctrl-cr to end a paragraph, as described in section 3.2. 

Bravo allows you to set up to 14 tab stops, which are named by the digits 1-9 and the letters abede. 
The tab stops are paragraph looks, just like the margins; hence they can be different for each 
paragraph. You can set a tab stop with the command 

Look tab t d 

where l is a digit or one of the letters abede, and d is a distance (see section 3.2). 

When you strike the tab key during typein, the caret moves to the next tab stop, just as it does on 
a typewriter, and a tab character is added to the document. This tab character is called a plain- 
tab, because it moves the caret to the next tab stop, not to a specific named tab stop. 

For example, suppose you have a line like this: 

Column 1 Column 2 Column 3 

Tab stops 1, 2, and 3 are at 180, 265 and 400 points, and there is a plain-tab between each digit and 
the following C. If you now append some x’s to the digit 1 to get past tab stop 1, the result will 
look like this: 

Column lxxxxxxx Column 2 Column 3 

That is, the point to which a plain-tab jumps depends on the width of the preceding text. This can 
vary both when you change the text and when you switch to hardcopy mode; thus, the appearance 
of hardcopy may not match the screen if you are using plain-tabs. 

You can turn a plain-tab into a named-tab by selecting it and issuing the command Look l t (Look 
comma t), where t is the name of a tab stpp. A named TAB character will always make the 
following character print at the correspondingly named tab stop. If printing has already passed that 
tab stop, Bravo will start a new line, and display a heavy black rectangle at the end of the previous 
line, to warn you that something is wrong. 

To continue the above example, suppose you name the first tab 1 and the second 2. Now the 
result will look like this: 

Column lxxxxxxx | 

Column 2 Column 3 

When you switch from normal display mode to hardcopy mode, there will usually be more white 
space occupied by the tab (perhaps enough to permit printing all the text on one line), but 
everything will continue to be positioned horizontally in exactly the same way. 
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You can find out the name of a tab stop by selecting it and giving the Look ? command. 

“ coi or t °p^ B ng Ch “ If aPPlied t0 3 CharaCter 0ther 

Ac" Ako P aS il M With 0W VerSi ° nS ° f BraV °’ and with 016 Programmer-oriented tab conventions of 
command ’ ^ C “ Set Unnamed ° r plain ^ spaced at equal internals wi the 

Look TAB _= d 

KIT. Sift 

above a paragraph, without using spaces, tabs or extra CRs. It is good practice to use these features 

cEcS'duST »p e s; ns d,2u™„r e pr " isel, and ' lon ' , ha,e ,o wonj ^ ““ 


3.6 Page formatting 

harrW^ nd allows you t0 see on the screen where die page boundaries will "ppeaMn die 

SSSSS l”? h^rdliy 1 page.l^klovellelrcln Ithlref il 

Se 1 Ae^ 0 fire^l^alr 3 of US ^ of 1 dS3 

As a convenience; the page boundary command leaves the original selecdon at the ton r>f m,. 

creates tf necessary) 6 HneTlteTsu blilow ?w°hih°Tt 

naoe anH th» Among other things, this makes it easy to do some editing near the end of the 
page, and then reselect the beginning of the page and repeat the command TYy it 

^ 0 vMf t !L y ; B K V0 wiU T n a ,? e . w page when k runs out of room on the current page i e when the 

can tvL In I Ml S PC v In Slmply by h ° Iding d ° Wn CTRL and typin § L ’ but instead you 

treated" just like “* 35 3 ^ LC is 

m° U n^Hnn SO ttS rce 3 pam i ra P h t0 *** a new pa 2 e by giving it a keep property of 11”. If you want 
to position the paragraph precisely on the new page, give it a vertical Lb property as wed 

You can exercise some control over where page breaks occur with the command 
Look Keep d d is a distance 

This sets the paragraph property called keep, which has the following meaning. During hardcopy. 
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when printing of the paragraph is begun, the amount of space left on the page before the bottom 
margin must be at least the keep distance, or a new page will be started. For instance, by setting 
the keep of a heading to the total height of the heading (including its leading) plus the height of 
the first two lines of the next paragraph, plus the paragraph leading, you can ensure that the 
heading will never end up alone at the bottom of a page. Good values to use, with standard fonts 
and leading as in this document, are 40 pts on ordinary paragraphs and 80 pts on headings. 

You can set the vertical position of a paragraph precisely on a page using the vertical tab property 
which is set by the command 

Look Z d d is a distance. 

When a paragraph with a vertical tab is printed, its upper edge (including leading, if any) will be 
positioned at the vertical tab value, measured from the bottom of the page (i.e., use 10.5" to put it 
.5 from the top). Unlike a horizontal tab, which may start a new line, a vertical tab never starts a 
new page; instead, it may cause overprinting. Vertical tabs are useful for positioning headings and 
footnotes, and for precisely aligning text to meet some physical constraint, such as a pre-printed 
form or a window envelope. The first line of a paragraph with a vertical tab will be printed on the 
current page, even if it runs into the bottom margin (but not if the paragraph also has a keeD 
property which forces it off the page). 


Vertical tab and keep properties are not visible on the screen, but you can always use Look ^ to 
find out whether a paragraph has them, and what their values are. 

Note that both line and paragraph leading are suppressed for the first line of a page of column. If 
you want white space in front of such a line /, you can use vertical tabs, or introduce a blank line in 
front of line /, and adjust the leading of / to compensate for the height of the blank line. 

The remaining aspects of page formatting can be controlled by an optional document profile which 
you can put at the very beginning of the document. The document profile is a sequence of 
paragraphs, each of which must have the profile property. This property is set and cleared by a 
Look command: 

Look i sets the profile property Look shift ; clears it 

A document profile has the following form (this one is the profile for this part of this manual): 

Page Numbers: Yes X: 527 Y: -.5” First Page: 40 Not-on-first-page 
Private Data Stamp: No X: 3.5" Y: -.6" 

Columns: 1 Edge Margin: .6" Between Columns: .4" 

Margins: Top: 1.3" Bottom: 1" Binding: -5 

Line Numbers: No Modulus: 5 Page-relative First Line: 1 

Odd Heading: Not-on-first-page 

Bravo Manual 

Even Heading: 

Section 3: Formatting 

Any of the lines may be omitted, and in general any of the fields on a line may be omitted. Fields 
on a line are separated by one or more spaces. Distances, shown in inches in the example may be 
given in points or centimeters, as described in section 3.2. X coordinates are from the left edge of 
the paper, Y coordinates from the bottom; negative coordinates are measured from the right edge 
or top Of an 8.5" X 11” page. Bravo’s measurements on the page are exact to less than .01". Actual printers 
however, can make errors in positioning the text on the page of as much as .25" in any direction. These errors do not 
allect the relative positrons of characters (e.g., the length of a line cannot be affected) but they can cause the text to shift 
around on the page as a whole. 

We now proceed to explain the various options. 



Page Numbers 
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proper authorization^' You" w!5 neS toTuppl^ a f %tiswo U rd P on Mch warn ?° n ° l h USe 3 privale data slamp withou t 
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The text width and position specified above is only nominal: the actual width and position is 
determined by the specified left and right margins in the following way. The first column is printed 
exactly as its left and right margins specify. The second column is moved right by (col width + 
between cols) from what its left margin specifies (i.e., that amount is added to all its X coordinates). 
This means, for example, that you can get a double-column page with some text at the top which 
runs all the way across by setting the right margin of the full-width text appropriately, and using a 
vertical tab to position the first paragraph of the second column below the full-width text The 
appearance of the resulting page will be 

Full-width text 

first-col text second-col text 


Note that to do this you must manually find the end of the first column (easily done using the page 
boundary command), and put a suitable vertical tab property on the first paragraph of the second 
column. 



A consequence of this laissez-faire approach to column formatting is that you must supply the 
proper left and right margins yourself. To keep the text within the nominal boundaries defined 
above, the left margin should be greater than or equal to the edge margin specified in the document 
profile, and the right margin should be less than or equal to the edge margin plus the column 
width. 

The edge margin specified in the example, which would be much too small for single-column pages, 
is good for double-column. It is also desirable to reduce the top and bottom margins when you are 
printing double-column, e.g., to .8" and .4" respectively. 

When you are printing more than one column, a L c in the document starts a new column rather 
than a new page. To start a new page, use two consecutive L c characters. 

Line Numbers 

If there is a line which says 

Line Numbers: Yes Modulus: n Page-relative First Line: / 

every nth line will be numbered, slightly to the left of the standard left margin. Thus, if n is 5, the 
numbers will be 5, 10, 15 .... If Page-relative appears, numbering starts over on each page; 
otherwise it continues throughout the document If First Line appears, the first line is numbered f, 
and numbering continues from there; otherwise the first line is numbered 1. 

Headings 

If a Heading line appears, it must be followed by a paragraph, also with the profile property, which 
is used as the heading on each page. This paragraph should have a vertical tab which positions it 
correctly (for example, 10.5" for the heading on this page) and appropriate margins, centering or 
whatever to produce the desired effects. It may have more than one line. It is also possible to have 
separate Odd Heading and Even Heading paragraphs. If Not-on-first-page is present, the heading 
will not be printed on the first page. 
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4. Other things 

l" S , ection you can learn about a wide variety of other useful things Bravo can do They are 

£STSF mm: ear,ier °“ s - *• ~ 


4.1 Some useful features 

h^ic S f tJ ™f eS ^ ribeS 3 number of Matures which are easy to learn and helpful to use. As always 
it is a good idea to try them out as you read about them. ^ ’ 

^ in flect entire hr f S of u the document by moving the cursor into the line bar ; which is to the 
m 1 3rea 3 n d t0 the nght . of the scro11 bar - You can tell that you are in the line bar 
enrirp S fi ^ C “7°Ji W ‘ L ap £ ear as 3 n 8 ht -pointmg arrow when it is in the line bar. To select the 

BmE button Roth nf th CU J sor - use , RED mouse button - To extend the selection, use She 
hnnL b t B lh of diese -work very much like selecting a character and extending. The YELLOW 
button selects a paragraph you can read about paragraphs in section 3.2. 

To put the current selection at the top of the screen, say Normalize. 

cu , rrcnt / a/e and lime in front of the current selection, say Time. Notice that it leaves 
th ^ tlme selccted ’ so lf you follow it immediately with a Delete, you will be left with just the 
u d nd e ersm 0 n^h C y C ^ ** ** ^ * and Sa * ^ Time Delete; be slmyoS 

You can searc/i the document for the next occurrence of some text with the Jump command After 
you say Jump you have to specify the text you want to search for, and you do this exactly the wav 
you make an insertion; by typing it in (ending with ESC), by making a copy selecrion or by typml 

Notice > hlCh Wa \ USCd f0r last Jump {not ^ inserbon or deletion)® 

mf. 1 . lf . y ou , J y P e m text, it appears between the right-most set of curly brackets in the svstem 
window, this is called the search key buffer, and it normally contains the last text you searched for 

h TT bUff6r ar£ deStT ° yed by ^ ^ ? command and some of the S.ator co^ani 

The search starts with the second line displayed in the window. If it succeeds it brings the first 
occurrence of the text to the top of the window; if it fails, a note in the system window informs 
you. Jump does not affect the current selection. The search ignores the looks of the characters. 

T° n u ,'f" substitute one text for another using the Substitute command. It will ask you (in the too 
^ 1 f ? r t , hC lnformat ' on u needs - In Poking for substitutions it will examine only the text in 
tfris S f ° lf H° U W3nt t( ? substitute throughout the document, do an Everything first 

aho„r IT h d .R cument J the cu jrent selection. For reasons you don’t want to know 

about, it is not a good idea to do a Substitute in which the old text contains a CR 

!hic St R BraV ° C0m [ nands can be repeated by simply typing ESC in command mode. When you do 

B aV °!i S p C L CUnent sclcct,on ' 1116 one which *0 previous command used. For example 
you can append a carnage return after each of several words by selecting the first one and 
Appending after it, and then selecting successive words and simply typing ESC Or you can search 
through the document looking for occurrences of a word b, Jumping™ it once and £ £ typSg 

¥ nd ° c °u™ and will undo the action of most Bravo commands which change the document 

art^s “r^erisrej 011 - onl> Undo “» m ° st 
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The ( command will put parentheses around the current selection. You can put other kinds of 
brackets around the current selection with the commands f, {, <, ’ and 

The } command expands the current selection as little as possible to make it balanced with respect 
to parentheses. This is useful primarily while editing algebraic expressions or programs. For 
example, if the current selection is the underlined character in 

X n+1 = ((aX n ) mod (m + 1) + c) mod m 
then one application of the ] command will extend the selection thus: 

X n+i = (( aX n ) mod ( m +D + c) mod m 
and another application will do this: 

X n + 1 = ((aX n ) mod (m + 1) + c) mod m 
Again, the J, }, and > commands do similar things. 


v 


4.2 Windows 
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So far you have worked with a single document in a single window. Bravo will let you work on 
several documents at the same time, each in its own window. This is convenient if you want to 
compare two documents, or copy something from one into another, say from an address list into a 
letter. You can also have several subwindows looking into the same document, which is nice when 
you want to copy something from one part of the document to another, or to check something on 
another page without losing your place. 

At the top of each window, separating it from the one above, is a heavy black bar. Inside this bar 
is the name of the file for the document in the window; this name is set by Get and used by Put 
It can be edited like any other text Subwindows, created only by the split operation described 
below, are separated by horizontal black lines. All the subwindows of a window are looking at the 
same document, although usually at different parts. If part of the document happens to be 
displayed in several subwindows, any changes to it will appear in all of them, and so will the 
selection underline or the insertion caret. Two different windows, on the other hand, are always 
looking at different documents, and no change to one window can affect the other. You can copy 
text freely from one document to another with a copy selection. 

Some commands, like Jump, Everything, Get, Put and Hardcopy, work on the current window, 
which is the window containing the current selection. 

There are two commands for windows, one for creating and re-arranging windows, and the other for 
destroying them. Each has three options, selected by the three mouse buttons. 

• 

To create a new window, type Window, move the cursor so that it marks the point where you want 
the new window boundary to be, and hold down blue. The new window will appear. As long as 
you keep BLUE down, you can move the cursor around and the top boundary of the new window 
will follow it. When you let go of the button, the boundary will freeze. Try it The new window 
will be empty, but you can insert or Get into it 


To split a window and create a new subwindow, type Window, put the cursor where you want the 
split, and hold down YELLOW. The new boundary will appear, and it will follow the cursor until 
you release yellow. It is important to understand that after a split you have the same document in 
each subwindow. Scroll one of the subwindows so that some of the same text appears in both 
subwindows, and select some of the common text. Notice that the selection appears in both 
subwindows. If you make changes to the document, you will see them in both subwindows. This is 
very different from creating a new window and Getting the same file into it; that is equivalent to 
taking another copy out of a file cabinet 
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In summary: 


RED 

YELLOW 

BLUE 


Window 

move boundary 
split; new subwindow 
new window 


give space to window above 
clear 

give space to window below 




4.3 If Bravo breaks 

error; if this happens repeatedly you should file an Aim tmnhi 1 may m ^ orm you °^ a parity 
(see section 5.1 of the Alto ^on-programmer’s Guidef A thi^H ° *?,— Alt ° re P aired 
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You can do all these things using a system called BravoBug. Thus, 

> BravoBug CR 

will start replaying your transcript As the replay proceeds, Bravo will report each command, just as 
it does when you type a command in the usual way. When it is finished, Bravo will say Ready, and 
you can go on editing. It is a good idea to save your work with a Put and start Bravo again. 


Warning : you can only do a replay if you haven’t started Bravo up again. Once you restart Bravo 
normally, your chance to replay is lost. 
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To report a bug in Bravo and then do a replay, type 
> BravoBug/R CR 

This will deliver to the Bravo maintainers copies of all the files involved in the bug, including the 
transcript, and then start Bravo to do the replay. 

You can control the replay, step by step, as described in this paragraph. To stop a replay which is 
going on, type a space. As soon as the command currently being replayed is finished, Bravo will 
stop and tell you the number of the next command. At this point you can type 

Quick to make typed-in text go in all at once during the replay, rather than one character at 
a time. This is faster, but you don’t get to see what is going on. Quick is the normal mode. 

Slow to make typed-in text go in one character at a time. 

space to replay one more command. Note: only commands which change the text or 
windows are recorded in the transcript, not scrolling operations. 

Proceed to continue replaying at full speed. You can stop the replay again at any point by 
typing a space. 

Break before command n to make the next Proceed stop before command n (of course, it 
will still stop right away if you type a space). This is useful if you know that the first 50 
commands are good, but want to proceed more cautiously after that. Note that after a Bravo 
crash, the Swat display usually tells you the number of the command during which the crash 
occurred. 

Terminate CR to terminate the replay. After terminating, you can proceed to give ordinary 
Bravo commands. Don’t do this unless you are sure that you want to stop replaying, since 
there is then no way to resume it 

You should try replaying a Bravo session and using these commands, so that you feel comfortable 
with them. You will then feel much more in control when you have a problem with Bravo or your 
Alto, or make a serious blunder while editing. 


4.4 Arithmetic 

Bravo incorporates a simple calculator, modeled after the Hewlett-Packard 35. The calculator has a 
stack with room for four numbers; while you are using it the top of the stack is displayed in the 
search key buffer, in the lower right comer of the system window. 

To enter a number in your document onto the stack, select it and type \ (enter). To add a number 
in your document to the top of the stack, select it and type _+ (or _=, which is the lower-case 
character on the same key). Similarly, you can subtract with multiply with * (or and divide 
with /. The % command is just like *, except that it divides the result by 100. After any of these 
operations, the top of stack is the current buffer, which means that you can insert its contents in a 
document by defaulting the text of the insertion with ESC. 
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There are a few more calculator commands which are occasionally useful: 

exchanges the top two elements of the stack- abed become* h n w 

§sr after “ ■>»"« » »• ■> * ™.i*ed » 2 . AB 

^ U ! a t t0r f iXed . r SetS 016 di$ P la y to fixed point (the normal mode), 
emulator Sctentrfic sets the display to scientific notation 
Calculator Ingmeering sets the display to engineering notation. 

HexadedmaT adlX ~ ** **“ Iad “' a Can be a or Binary, Octal, Decimal or 


4.5 Other useful features 
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Partial Substitution 

If you want to substitute "that" for "this" you can use the Substitute command described in section 
4.5. If you want to change some of the occurrences of "this" to "that", however, it is useful to 
know about the Find and Yes commands. 

Find is exactly like Jump, except that 

the search starts from the end of the current selection, not from the top of the display; 

the occurrence of the key which is found becomes the current selection (Jump leaves the 
selection unchanged). 

Yes is equivalent to Replace ESC Find ESC. So, to change some "this"es to "that”s, proceed as 
follows: 

select something before the first place you want to start looking; 

Find this ESC: 

ESC to repeat the Find until you get the one you want to change; 

Replace that ESC ; 

Find ESC ; 

Now at each point type ESC (i.e., repeat the Find) to make no change and go on to the next 
"this", or Yes to make the same change you made last time and then go on. 


Control and Special Characters 

Bravo normally displays a control character as the corresponding lower-case letter (or whatever) with 
an overbar. If you turn on Look graphic it will try to display the control character from the font (if 
there is something in the font for it; otherwise it will display a black rectangle). This is a character 
Look, just like Look Visible. 

You can’t type a control character in directly, but you can type the corresponding regular character, 
followed by a S c , which converts the preceding regular character into a control character. 

Certain font families (notably TimesRoman and Helvetica) contain extra characters, such as accents, 
ligatures, and several sizes of dashes and spaces, which are useful in creating very high-quality 
documents. These may be entered as control characters in graphic mode (use Look graphic). The 
correspondence between control characters and their printed representations is as follows. 

Accents. Each of these has a width of zero, so should be typed in immediately before the 
character above which it is to appear. 


d 

ds c 

example: 

do 

e 

es c 


eo 

k 

ks c 


ko 

P 

ps c 


po 

Ligatures: 

ff 

fs c 

replaces: 

ff 

ffi 

qs c 


ffi 

ffl 

rs c 


ffl 

fi 

ts c 


fi 

fl 

us c 


fl 
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Quotation marks: 

g s c open single quote 

close single quote (standard apostrophe) 

Note that you can make open and close “double quotes” by using pairs of the 
corresponding ‘single quotes’. 


Spaces and dashes: 

II 

space bar 

letter space; here are 10 of them: | 

1 1 

y s c 

figure space: | | 

1 1 

os c 

em space: | 


- 

hyphen: 

- 

vs c 

en dash: 

— 

n s c 

minus sign: 

— 

ss c 

em dash: 

Miscellaneous: 



i 

b s c 


9 

cs c 


i 

hs c 



At the time this manual was prepared, the special characters had not yet been incorporated into the *.al display fonts. 
Until this has been done, these characters will all appear as black rectangles on the screen. To find out which control 
character one of these black rectangles corresponds to, turn off its graphic look. 


4.6 The user profile and fonts 

The file User.cm is your user profile, which contains information for various systems about how you 
want them to be set up for your use. The information for each system starts with the name of the 
system in brackets, e.g. [bravo]. Then follow a series of lines of the form 

label: information 

Bravo currently accepts three kinds of information in the user profile: initial and quit macros' 
described in the next section, and font definitions and default parameter settings, which are 
discussed here. Look at your User.cm file now, to see how this works. 

Each line of font definition tells 
the number of the font (0 to 9) 
the name and size (in points) of the hardcopy font 

the name and size of one or two screen fonts which can be used to represent that hardcopy 
font on the screen. Bravo will use the first one normally but the second one (if present) in 
hardcopy mode. 

For example, the line 

font:0 TIMESROMAN 10 TIMESROMAN 12 TIMESROMAN 10 
says that font 0 is to print as 10 pt Times Roman when you generate hardcopy. 

The rest of the line says that font 0 can be represented on the screen by the screen fonts stored on 
files TimesRomanl2.al and TimesRomanlO.al, which must be present on your disk. Bravo will use 
the 12 pt version in normal display mode and the 10 pt version in hardcopy mode. The extension 
"al" is used for screen fonts. There are no files for the bold or italic versions of screen fonts 
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because Bravo can construct them from the regular version. 

In addition to all the *.al files, you must also have a file called Fonts.widths, which contains 
information about the widths of all the characters in the hardcopy fonts. 

Warning: A Bravo document file does not contain the association between the font numbers and names used to create 
that document. If you modify the font definitions in your user profile, you may encounter problems when you attempt 
to share Bravo documents with other people. 

The user profile also contains settings for 
default left and right margins; 
tab interval; 

Look nested parameters; 

default line leading (used by Look X) and paragraph leading (used by Look Open, Look Q 
and the default for Look Y); 

standard offsets (used by Look t. Look and the default for Look Up and Look Down). 

You can change all these settings by editing User.cm in a way which should be obvious; after doing 
this, be sure to initialize Bravo. Except for the default margins, all these settings affect only the 
process of editing the document, and not the document itself. In other words, once a Look nested, 
superscript or whatever has been done, the margins, offset, etc., have been set in the document and 
cannot be affected by subsequent changes in the user profile. 

There is also a [HARDCOPY] section in the user profile that is used both by Bravo and by other 
subsystems that generate hardcopy. This contains entries for 

preferred printing format (Press is the only reasonable choice at present); 
name of your Press printer; 

the name to be inserted in the "Printed by" field on the break page of the printout (an 
occurrence of "$" is replaced by the name by which you are known to the Alto Executive). 


4.7 Startup and Quit macros 

This section is only for programmers, and is not recommended even for them. 

You can put into your user profile sequences of Bravo commands, called macros, to be executed 
automatically when you start up or quit from Bravo. Each macro is named by a letter. Startup 
macro x will be executed if you start Bravo with 

> Bravo/x . . . 

Quit macro x will be executed if you type an "x” instead of CR after typing Quit 

You can see the format of a macro definition by looking at your user profile. The command 
sequences are just like those which Bravo writes into the transcript (the file Bravo.ts), and can be 
constructed by actually executing the desired sequence of commands, and then copying Bravo.ts to 
another file and copying the sequence out of that file. There are two exceptions: 

* in place of a selection (which looks like {6,2,123,648}) means the current selection; 

@n in place of typed-in text (which looks like ’text{) means the nth parameter. For startup 
macros the parameters are strings on the command line separated by blanks; the first one 
after Bravo/x is numbered 1. For quit macros, parameters 1, 2 and 3 are the three buffers, 4 
is the file name for the first window, 5 the file name for the second window, etc. 
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Fonts 


Times Roman 

Font 0 = 10pt., Font 1 = 8pt., Font 5 = 12pt. 
Available in 6, 7, 8, 10, and 12pL in Reg., Bold, Italic, and Bold 
Italic. 

Available in 18pL in Reg. and Bold. 
tO = Em Quad; tY = En Quad & Fig. Space. 

Space Bar = 1/4 Em Quad. 
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1. Introduction 


What is Laurel? 

Laurel is an Alto-based, display-oriented, message manipulation system. It provides facilities that 
permit its users to display, forward, classify, file, and print messages, and to compose and transmit 
messages and replies. Laurel is an initial component of what will ultimately be a distributed 
message system. Although the distributed nature of this system has inherent technical interest, it is 
largely transparent to the users of the system, who see a collection of logical facilities resembling 
those provided by MSG on Maxc. Eventually, the services of Laurel will surpass those of Msg, but 
at present, the two are roughly equivalent in function. The important distinction for now is that 
Laurel executes on an Alto and uses the display in a fashion befitting Alto-based software. It also 
produces files that can be manipulated by other Alto subsystems. 

Many initial users of Laurel will be familiar with MSG and will naturally be interested in the 
functional differences between MSG and Laurel. This manual, in addition to presenting the 
facilities of Laurel, points out some of the incompatibilities with MSG. Prospective Laurel users with 
strong lies to MSG should read section 5 carefully before committing themselves to Laurel. The 
Laurel team fully expects that some potential users will find the transition to Laurel too 
uncomfortable to undertake at present. Accordingly, we have provided a "free sample” of Laurel in 
the form of a tutorial (see section 2), which can be run without any commitment to further use of 
Laurel or danger to Msg files. We would much prefer that Laurel users "go in with their eyes 
open" and not be unpleasantly surprised when confronted by incompatibilities. 


What is this manual? 

* ■ 

’ This manual is a reference document for Laurel. The Laurel team believes that most of the basic 

facilities of Laurel are self-explanatory, and that you can probably use Laurel quite competently 
after reading only the introductory sections of this manual. (There is also a tutorial available to 
guide new users; see section 2.) However, Laurel has features that are not immediately obvious, 
and after becoming acquainted with the system, you will want to read about these facilities. The 
Laurel team will be very happy to hear any suggestions you may have, and is particularly interested 
in your experiences in using the initial system. Comments should be sent to LaurelSupport (using 
the facilities provided by Laurel!) 

% 

The version described in this manual is Laurel 2.0. Laurel displays its version number in the 
upper-left comer of the screen. Future versions of Laurel containing major new capabilities will 
change the integer part of the version number, whereas maintenance releases will change the 
' fractional part. 

V 

\ 

2. Basic notions and facilities 



Laurel is a display-based, interactive program that manipulates a particular class of files, called mail 
files. In essence, a mail file is just a sequence of messages , each of which is a text string formatted 
according to certain conventions. The details of these conventions are not of major interest to most 
users — suffice it to say that messages have a header and a body, a header contains (at least) a sender, 
a subject, one or more recipients, and a date. For each mail file, Laurel constructs and maintains a 
table-of-contents that summarizes the messages residing in the file. Mail files are private to each 
user, meaning, at present, that your mail files reside on your own Alto disk(s). Laurel provides 
facilities for manipulating mail files, examining and responding to messages, composing and sending 
new messages, and cataloging, filing, and printing messages. These functions are discussed below. 





How to obtain Laurel 

We recommend strongly that new users obtain a Non-Programmer’s disk to be used primarily for 
processing and managing messages (see section 5 for the reasons behind this recommendation). The 
Basic NON-PROGRAMMER’S Disk already has Laurel installed, so if you have obtained a copy of 
this disk (by the procedure described in the Alto Non-programmer’s Guide), you may skip the next 
paragraph. 

Two Alto command files are available on most file servers for obtaining Laurel. If you are a new 
user, you should issue the following commands to the Alto Executive: 

> Ftp FileServer Retrieve <Laurel>LaurelNewUser.cm CR 
> @LaurelNewUser^ 

This obtains Laurel and starts it up in a tutorial mode. If you are already familiar with Laurel, you 
should retrieve and execute <Laurel>Laurel.cm, which merely retrieves the files necessary to run 
Laurel. 

Note to Mesa programmers: Laurel 2.0 is a Mesa 4.1 program and therefore requires the Mesa 4.1 version of 
RunMesa.run to be on your disk. For this reason it can't coexist on a disk with a version of Mesa other than 4.L 

Before using Laurel’s hardcopy command for the first time, you must edit your Laurel profile (file 
LaureLProfile) to declare the name of the printing server to which your hardcopy is to be sent See 
section 3.6 for information on the Laurel profile. 

How to run Laurel 

To invoke Laurel, type 
>Laurel CR 

to the AltO Executive. This is the default method of invoking Laurel. Command line options are discussed in 
section 3.5. 

To invoke the Laurel tutorial (after obtaining it with @LaurelNewUser), type 
>Laurel Help CR 


2.1. The user interface 

Laurel is a highly interactive system in which economy and clarity of expression are essential. In 
striving to provide a convenient user interface. Laurel borrows a number of conventions familiar to 
users of other Alto subsystems. This section describes the principles that underlie the Laurel user 
interface. 


Command invocation 

Most Laurel facilities are invoked by use of the mouse, with the keyboard being used almost 
exclusively for text entry. Commands are generally represented by words or phrases on the display 
screen. You invoke a displayed command by moving the mouse until the screen cursor points at 
the desired command, then clicking a mouse button (usually red). If you hold down RED and 
move the cursor to point at a command, the command will appear inverted (i.e., white letters on 
black background). When you release the button, the command name will appear grayed (i.e., black 
letters on a gray halftone background). If, while holding down the mouse button, you change your 
mind about the command you intend to select, simply move the cursor until the inverted name is 
restored to its normal state, then release the button, a fine point: position the cursor so that it points at the 
command, not so that it rests on top of it 
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Normally, you use RED to invoke commands. Some commands have such a significant effect on the 
current state that you must confirm them explicitly, and in such cases Laurel will prompt you. If 
, r you are certain in advance, you may invoke the command by clicking BLUE. Laurel will then 

' ilie suppress the prompt for confirmation and execute the selected command immediately, 

y of 

r t Laurel prompts you for confirmation by displaying the message 

Type ESC to confirm, DEE to cancel command. 

in the feedback region at die bottom of the screen. It also displays a large flashing question mark 
new in the cursor. You may confirm by typing ESC, CR, Y, or space, or by clicking YELLOW. If you 

type DEL Or N, the command will be aborted. Ultra-fine point: if you change your mind after pressing 
YELLOW, buL before releasing it, clicking RED will turn it into a DEL! 


you Type-in conventions 

n 

Laurel observes most of the standard Alto type-in conventions. When it expects you to supply text, 
it displays a blinking caret at the appropriate place on the screen. Striking BS or A c deletes the 
’ n -° f character to the left of the caret; W c deletes the word to the left of the caret. Type-in may always 

be terminated by typing ESC; sometimes other characters will terminate input as well (see below). 

^ l e Commands that do not permit you to make a secondary selection may also be terminated by clicking YELLOW. 

See 

Brackets 

Several Laurel commands require text arguments. In particular, commands that manipulate a file 
need to know die name of the file on which they are to act Text arguments appear in { brackets } 
following the command name on the screen. 

When you invoke such a command with RED, Laurel prompts you to fill in the brackets by 
ed ln displaying a blinking caret within the brackets. If there is already text within the brackets, the caret follows 

the text. In addition to the type-in conventions described above, the following rules apply: If you 
type ESC, CR, TAB, or space, or click YELLOW, the caret disappears and the contents of the brackets 
remain unchanged. If you type BS or W c the contents of the brackets will be edited as if you had just typed that 
text If you type anything else (except as described above), it replaces the complete text within the 
brackets. Type-in is terminated by ESC, CR, TAB, space, or YELLOW. Typing DEL aborts the entire 
command. 

If you invoke the command with blue rather than red. Laurel executes the command immediately, 
using the text argument already contained within the brackets, with no further action on your part. 
a [ 0 This is true of all commands that have text arguments in brackets, with the exception of the user command. 

„ „er • 


most 
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it at 
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rs on 
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at the 


2.2. The display 

Laurel maintains four regions on the display screen. From top to bottom they are: the table-of- 
conlenls region, the message display region, the composition region, and the feedback region. The 
table-of-contcnts region holds a directory of the messages residing in the current mail file. The 
message display and composition regions are used to examine messages received and to compose 
messages to be sent, respectively. The feedback region displays various information (frequently 
error notifications) appropriate to particular Laurel commands. Each region will be discussed in 
detail in subsequent sections. 

The display also has three command menus. The topmost menu, just above the tablc-of-contents 
region, contains a number of miscellaneous commands and status information. The commands, like 
all commands on the Laurel screen, appear in bold-face type; the status information is in normal 
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type. We call this simply the upper menu. Below the table-of-contents region and above the 
message display region is the selection menu. The commands in this menu are used to manipulate 
selected entries in the table-of-contents. Below the message display region and above the 
composition region is the composition and delivery menu. As the name implies, this menu contains 
commands that facilitate the composition of new messages and responses to old ones. The 
composition region is separated from the feedback region by a single horizontal line. 


Scrolling and thumbing 

The table-of-contents region, the message display region, and the composition region each have a 
scroll bar in the margin to their extreme left. Within this scroll bar, the RED and BLUE mouse 
button behave as they do in Bravo. The cursor will appear as a double-headed arrow when 
positioned in the scroll bar and will change to point up or down when RED or BLUE is pressed. 

Thumbing differs substantially from the Bravo style. At the top of each of the scrollable regions is a 
horizontal bar that separates the region from the menu above. When the cursor is positioned just 
below this bar and YELLOW is depressed and held, a short vertical line segment appears on the bar. 
Moving the mouse to the left or right causes a corresponding movement in this line segment. The 
position of the line segment relative to the left edge of the horizontal bar identifies a location within 
the text associated with the region. Thus, moving the line segment to the extreme right edge of the 
bar identifies the end of the associated text; positioning it in the center of the bar specifies the 
middle of the text. When YELLOW is released, the identified position is brought to the top of the 
region. 

A portion of the thumbing bar appears as a dashed line, whose position and length correspond to 
the text displayed in the window. Thus, positioning the line segment at the left edge of the dashed 
line identifies the beginning of the currently displayed text. (Releasing YELLOW at this point 
naturally has no effect on the display.) 

As you will see shortly, it is possible to select entities within the table-of-contents and composition 
regions. The position of the selected entities in each region is indicated on its associated thumbing 
bar by a short verdcal line segment. This segment is always present, and should not be confused with the line 
segment that appears when you depress YELLOW. You can therefore obtain the effect of Bravo’s Normalize 
command by pressing down on YELLOW and positioning the cursor so that it coincides with the 
permanent segment on the thumbing bar. Releasing the mouse button then causes the selected text 
to be moved to the top of the region. 


Adjusting region sizes 

You can adjust the boundaries of the three major regions using the small squares at the upper right- 
hand corner of the two lower menus. Point die cursor at the desired box, then press down and 
hold yellow. By moving die mouse up or down, you drag the box with you to a new position on 
the screen. When you release the mouse button, the menu will move to the new posidon, and the 
contents of the adjacent regions will be adjusted accordingly. A fine point: you may find it more 
convenient to hold down YELLOW and move the cursor to the vicinity of the box. The box will capture the cursor 
when it comes sufficienUy close. 


2.3. The table-of-contents region 

This region provides an index to the messages in the current mail file. Each entry in the index is 
numbered and contains the date sent, the sender, and the subject. It is also possible for each entry to have 
a mark character for classification purposes — we will discuss this in section 3.1. Laurel docs not permit yOU tO 
modify the information in the table-of-contents window (except the mark character). 
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When Laurel begins execution, it normally gets the default mail file and displays its table-of- 
contents in the top region on the screen. It also places a selection pointer (which appears as a small 
black triangle pointing to the right) next to the last entry in the index (or first unexamined entry, if there 
is one). This pointer is used to identify messages that you wish to manipulate, and can be 
repositioned with the mouse buttons. We will discuss it in detail shortly. 
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2.4. The upper menu 

The upper menu contains some obvious status information: the date and time, the version of 
Laurel you are running, and the amount of free space remaining on your Alto disk. There is also a 
space reserved for posting the status of your in-box— see section 3.4. Of the remaining items, which are all 
commands, we discuss only Mail file and New mail here. The other commands are documented in 
sections 2.8 and 3.3. 


Mail files 

Laurel maintains one or more mail files for you. You should think of mail files as folders in which 
you organize the messages you receive. When Laurel is first started, it normally checks to see if 
you have a file folder labelled "Active.mail", and if not, it creates an empty file and labels it for 
you. This file is called your default mail file and is generally used to contain new messages that you 
have not yet processed. You will see how additional mail files are created in section 3.1. 

To direct Laurel’s attention to a mail file other than the current one, proceed as follows. Point the 
cursor at Mail file in the upper menu and click RED. A blinking caret will appear in the brackets 
following the command, inviting you to type the name of the file you wish to examine. (See the 
description of {brackets} in section 2.1.) After you have supplied the file name. Laurel will fill the 
table-of-contents region with the entries from the designated file. You can then use the facilities 
described in subsequent sections to manipulate this file. 

Mail file {file} always reads from the file whose name is displayed in the brackets. However, it 
observes two conventions that simplify type-in. First, if the displayed name does not contain a 
period. Laurel implicitly appends ".mail" to the displayed name before accessing the file. Second, if 
Mail flic is invoked with blue rather than RED, Laurel omits the prompt for a file name and uses 
the name currently displayed. 

A fine point: Laurel acts on deletions (see section 2.5) whenever either Mail file or Quit is selected. Thus, you cannot 
Undelete messages in a mail file once you have switched Laurel s attention to a different file. 
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New mail * 

Messages that are waiting for you reside in your in-box. The in-box is also called the mail box, but we will 
avoid this term to prevent possible confusion with mail file. Y OU instruct Laurel to move the contents of your 
in-box to your current mail file by pointing the cursor at the New mail command in the upper 
menu and clicking RED. The command will then appear on a gray background and the cursor will 
assume the shape of an hour-glass, confirming that Laurel is busy shuffling messages. You will also 
observe the free page counter changing. When all messages have been transferred, the gray background 
and hour-glass will disappear, and the table-of-contents window will be updated to reflect the new 
messages placed in your mail file. Transferring the contents of your in-box to your mail file renders 
the in-box empty. 


As the New mail command is completed, the table-of-contents region is scrolled so that as much as 
possible of the new mail is displayed, and the selection pointer is set to point at the first new 
message. You will also observe that each new entry has a ”? to its left this indicates that the 
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contents of the associated message have not yet been examined. The "?" is a mark character, you 
can change it to provide a (primitive) classification of the message — see section 3.1. 


2.5. The selection commands menu 


Displaying messages 

Normally, to examine the contents of a message, you must first select its table-of-contents entry with 
the selection pointer (sec below). However, after obtaining new mail from your in-box Laurel 
automatically selects the first new message for you. To display a selected message, simply point the 
cursor at the Display command in the selection commands menu and click red The selected 
message will then appear in the display region just below the menu. You may scroll the message or 
adjust the boundaries of the region for more convenient reading. 

To examine the next message listed in the table-of-contents, click Display again. The selection 

P i°u nter ui , moved t0 the next entr y. and the text of the message will be displayed. Thus 
although i-aurel permits you to move the selection pointer explicitly (see below), you need not do 
firne^ irn P ^ C IC ^ ^ ls Pl a y repeatedly and Laurel will advance the selection pointer by one entry each 

p0int: Laurel Wi " Skip ? ver deleted messa ges (see below) when advancing the selection pointer To display a 
deleted message, you must select tt explicitly, then click Display. P uispiay a 


Selecting messages 

Entries in the table-of-contents region are selected in the same way that lines of text are selected in 
Bravo. Position the cursor to the right of the scroll bar next to the entry you wish to select. The 
cursor wifi appear as a right-pointing arrow when it is properly positioned to change the selection 
pointer. Click red. The selection pointer will move to the indicated entry. By performing explicit 
selections, you may examine the contents of your mail file in any order you wish. 

More generally you can select any consecutive group of entries in the table-of-contents. This is not 
particularly useful if you only wish to display messages, but can be convenient if you wish to delete 

LrH°^ P °rk m f SSa x gCS v SCe £ el0w) ; m0ve 3 group of messa 8 es to another file (section 3.1), or generate 
hardcopy (below). You first select a single message, as described above, then extend the selected 

pm e ,n!i m D mr 8 • the cur t 0r u Ither up 0r d0wp and clickin S BLUE. Thus, selections are made with 
red and blue in much the same way they are in Bravo. YELLOW has no effect 


Deleting and undeleting messages 

After examining some of the messages in your mail file, you may wish to delete them The Delete 
command, when activated by pointing the cursor at it and clicking red, will cause a line to be 
drawn through all selected entries in the table-of-contents. You may find it convenient to use 
Display and Delete alternately when processing newly-arrived junk mail. 

If you discover that you have inadvertently deleted some messages that you want to keep simply 
reselect them if necessary, position the cursor over Undelete, and click RED. The lines drawn 
through the table-of-contents entries of the selected messages will be removed. 

Deleted messages are expunged (i.e., removed permanently) from the current mail file whenever a 
Quit (see section 2.8) or Mail file command is executed. 
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Generating hardcopy 

To print a copy of one or more messages in your mail file, select the message or messages in the 
table-of-contcnts, point at Hardcopy, and click RED. Laurel will generate hardcopy of each message 
in the form of an inter-office memorandum, one page (or more if necessary) per message, and send 
it to be printed on your default printing server. Messages that have been deleted (i.e.. whose lablc-of-contents 
entries have lines through them) will not be printed, even if they are selected. 

There are no options that you can exercise at the time you issue the Hardcopy command. However, by changing your 
Laurel profile , you can control certain aspects of the hardcopy formatting as well as a few other things such as the name 
of your printing server (see section 3.6). 


2.6. Composing and delivering messages 

Composition is the process of building the header and body (see the beginning of section 2) of a 
particular message. Delivery is the process of transmitting a composed message to its specified 
recipients. Laurel separates these two actions and supplies distinct commands appropriate to each in 
the composition and delivery menu. 

Laurel provides four ways to initialize the content of a message. You may compose a new message, 
or answer one you have received, or forward an existing one to a new recipient, or get a previously- 
composed form or message from a file on your Alto disk. In the composition and delivery menu 
(below the message display region), there are four commands corresponding to these actions: New 
* form. Answer, Forward, and Get. Simply select the one you wish by positioning the cursor 
appropriately and clicking RED. If the composition region contains an undelivered message, these commands 
request confirmation before constructing a new form. As in other such contexts, selecting these commands with BLUE 
automatically supplies confirmation. Even after confirmation. Undo (see below) can still be used to recover the previous 
contents of the region. 

It is important to understand that New form. Answer, and Forward only provide a message form\ 
you must edit the form before requesting that it be delivered. Get will be described in more detail 
later (section 3.2). 


Composition 

New form gives you a new message form in the composition region. The form contains "To", 
"Subject", and "cc" fields, which you should fill in as appropriate. Laurel provides a subset of 
Bravo’s editing commands to permit you to compose these fields and the message body. Laurel 
provides the Append, Delete, Insert, Replace, ESC (repeat) Undo, and secondary selection functions 
of Bravo, butdoes not handle Italics, bold-face, multiple fonts, or any "looks". For important additional 
editing functions, see section 3.2. In short, the message you compose is simply an unformatted text string. 
However, Laurel does supply automatic line breaks as Bravo does, so you need not type CRs except 
to produce white space. 

At present, the Laurel editor is not quite compatible with Bravo, though it may be in the future. In particular, you 
should be aware of the following differences. An Undo will undo the previous command. Undo always undoes the 
previous command exactly where it was given. To move text from one place to another use Delete followed by Insert 
ESC . New form, Answer, Forward, and Get may also be undone. 

In general. Laurel imposes format restrictions only on the message header. By definition, the header 
ends at the first blank line (i.e., two successive CRs). You should therefore be careful not to delete 
the blank line provided by Laurel in each of the three initial forms. The header itself consists of a 
sequence of fields, some of which are required to be present When composing a message you 
should always fill in the "To" field and the "Subject" field; you may delete the "cc" field if it is not 
needed. When the message is ultimately delivered (see below). Laurel will supply your name and 
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the date, so you need not include them explicitly. 

Answer and Forward initialize a message form in different ways, but both take information from the 
message currently displayed in the message display region (which is not necessarily the one selected in the 
tabie-of-contents region). Answer fills in the "To" field with the sender of tine currently displayed 
message and sets the subject to be "Re: sender's subject". It also sets the "cc" field to include all of 
the recipients of the message being answered. If you don’t like these substitutions, you may, of 
course, change them using the editing facilities. Forward copies the message body from the display 
region into the composition region. After clicking either Answer or Forward, you must complete the 
message by editing any remaining uninitialized fields in the message header and body. 

Laurel identifies fields that it expects you to replace by supplying a keyword bracketed by black 
rectangles, e g., IRccipientsl. Laurel will refuse to deliver any message whose header contains one 
field 6Se ” C C * S P rotccts y° u fr° m simple oversights, such as forgetting to supply a "Subject" 

Delivery 

Once you have composed the message you wish to transmit, you may initiate its delivery to the 
recipients by pointing the cursor at Deliver and clicking red. Laurel will fill in your name and the 
date (though they won t appear in the composition region) and proceed to send the message. A 
gray background will appear behind the Deliver command and the cursor will change to an hour- 
£j ass ’ . Laurel discovers an error in the list of recipients, it will give you an opportunity to cancel 
the delivery and correct tire mistake. When the list is acceptable (i.e.. all specified recipients are known to 
have m-boxes), Laurel will deliver the message and remove the hour-glass and gray background. 
After successful delivery, the word Deliver will disappear and will be replaced by "delivered' If an 
error occurs during delivery, an explanation of the error condition will be displayed in the feedback 
region. You may cancel delivery while the message " Type del if you wish to cancel delivery " 
appears in the feedback region. * 

SIS*™"* , V 0ur I namt j in a composed message. Laurel will check to see if the message header already contains a 
"From" field ,hl ' Laurel .j ns ® rts , a Sender field with your name and leaves the "From” field untouched. It is the 
name— se^ section 3 3 °™™ y dlSplayed in me “ble-of-contents. The name Laurel furnishes is your logged-in user 

me Tr the T b6r ° f reC ! P !, enla 10 whom il wil1 deliver message. If this number exceeds 30, you must 
confrm the delivery This is intended to minimize unmtenUonal deliveries to large distribution lists. Deliver also tells 
you the size of the message (in characters). 


2.7 The feedback region 

Laurel uses the feedback region for three classes of information: status reports, exceptions, and 
confirmation requests. Status reports are displayed by various commands, e.g.. Deliver to report 
circumstances of interest to you but which require no direct action on your part Exceptions are 
notifications of errors committed by you (or Laurel) and are flashed to alert you that some 
corrective action is probably required. Confirmation requests (see section 2.1) flash both the 
feedback region and a ? in the cursor, alerting you to the need for immediate action before 
Laurel can continue. 
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2.8 Leaving Laurel 

To exit from Laurel and return to the Alto Executive, point the cursor at Quit (in the upper menu) 
and click RED. Laurel will prompt you for confirmation. After you confirm, Laurel will act on the 
deletions indicated in the table-of-contents region, eliminating all messages from the mail file that 
have lines drawn through their table-of-contents entries. If you invoke Quit with BLUE, Laurel will 
omit tire confimation prompt. When you re-enter Laurel at a later point, these messages will no 
longer appear in the table-of-contents. They are gone forever. 

Leaving Laurel by any means other than Quit is not recommended and will slow down subsequent 
re-entry to Laurel. 
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3. Additional facilities 


3.1. Filing and classifying messages 

Laurel provides two facilities to assist you in classifying your mail. Remember that your default 
mail file should be viewed as holding those messages upon which you have yet to act. Naturally, 
you may want to file away those messages on which you have already acted. The command Move 
to {file} in the selection menu allows you to do this. Mark characters provide a simple means of 
attaching labels to individual messages within a mail file. 


Move to {file} 

To invoke Move to {file} proceed as follows. First, select (with selection pointers — see section 2.5) 
the messages you wish to transfer to a separate file. Next, point the cursor at Move to and proceed 
as you would for Mail file (sec sections 2.1 and 2.4). After you have supplied the file name. Laurel 
will append the selected messages to the indicated file. Laurel will draw a line through the table-of- 
contents entries of the messages that have been moved so that the corresponding messages will be 
deleted when you leave Laurel (or change mail files). If you wish to retain any of these messages in 
the current mail file as well , you may use "Undelete” as described above. Laurel will also mark (in 
the mark character field — see below) moved messages with an "m". 

Move to does not move any messages that are indicated as deleted. If a range of messages 
containing both deleted and non-deleted messages is selected for Move to, only the non-deleted 
messages are moved. 

Move to observes the same type-in conventions that Mail file does. It also implements one other 
convention that guards against misspelled file names: if the displayed file name does not 
correspond to any existing file. Laurel prompts you for additional confirmation before creating and 
writing a new file with that name. 


Mark characters 

You may wish to classify messages within a particular file. laurel provides a primitive marking 
system by allowing you to supply a single mark character for any table-of-contents entry. To set the 
mark character, position the cursor to the left of the desired entry but to the right of the line bar 
and selection pointers. Click RED. A blinking caret will appear, inviting you to type a single 
character. This character will be retained in the table-of-contents entry and displayed whenever the 
entry is in the region. It will also be retained in the message if it is moved to another file (using 
Move to {file}). Note that "?" and "m" are valid mark characters but have additional semantics assigned to them by 
Laurel. Other mark characters may be assigned special meanings in the future, e.g., to permit selective display of the 
table-of-contents. You may change the mark character by positioning the cursor over the mark to be 
changed and repeating the preceding steps. A space is a valid mark character. 


3.2. Additional editing and delivery facilities 


Secondary selection 


Laurel supports secondary selection (for Insert, Append, and Replace commands) in the same 
manner as Bravo docs. That is, you may identify the text string to be inserted by using the mouse 
buttons to select characters, words, lines, or paragraphs. You may select text in either the message 
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display region or the composition region, and you may scroll or thumb within either region while 
making the secondary selection. 


Paragraphs 

jit Although Laurel does not implement Bravo’s notion of paragraphs, it does provide a selection mode 

• !y, that gives similar results in simple cases. Laurel defines a paragraph terminator to be two successive 

love CRs. You may select a paragraph by positioning the cursor in the line bar to the left of the desired 

of text and clicking YELLOW, just as in Bravo. The main visible difference is that Laurel will not 

display Bravo’s paragraph symbol in the cursor. 


Distribution lists 
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Suppose you have a collection of people to whom you frequently send messages. To avoid having 
to type the entire list of names every time you send a message to the group, you may proceed as 
follows. Create an Alto file containing the list of names (separated by commas, no CR at the end). 
You may find it convenient to "label" such distribution lists; you may do so by prefixing the list with identifying text 
followed by a colon, and then terminating the entire list with a "matching" semicolon. For example. such a file 
might contain 

Alpha users: Brown, Doe, Jones, Smith; 

Name this file "AlphaUsers.dl". 
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Now, when composing a message in Laurel, insert the file name in the appropriate field of the 
message header (e.g., following "To" or "cc"), followed by an up-arrow character: 

To: AlphaUserst 

While delivering the message. Laurel will read the file to determine the recipients. Multiple 
distribution list specifiers may be used within a single field and may be intermixed with names of 
individual recipients — separate them all with commas. If you give your distribution list files the 
extension ".dl", you may omit typing the ”.dl" to Laurel. 

You need not worry about a recipient appearing in more than one distribution list. Laurel will 
detect duplicate names among the recipients and ensure that each receives the message only once. 
Thus, you may use multiple distribution list specifiers freely within the "To" and ”cc" fields of the 
message header. 


The present distribution list mechanism is a temporary one, and has some inconvenient aspects. In particular, since 
distribution lists are presently stored on your own Alto's disk, they can get out-of-date rather easily. Commonly-used 
distribution lists are maintained centrally, presently as files <Secretary>*.dl on Maxc. We have tried to streamline the 
task of keeping distribution lists current by providing a command file, DLUpdate.cm, which updates local distribution 
lists from the central source. Registered Laurel users (i.e., those listed in LaurelUsers.dl) are notified when DLUpdate.cm 
should be run. DLUpdate.cm is automatically retrieved by Laurel.cm and LaurelNewUser.cm (see section 2). Note that 
DLUpdate.cm updates only those distribution lists that you already have on your disk. To obtain a copy of a distribution 
list you don’t already have you must use FTP to retrieve it from the <Secretary> directory on Maxc. Thereafter, running 
DLUpdate.cm will keep it up-to-date along with all the others. 


Get and Put 

The composition and delivery menu includes the commands Get, Put {file} for filing and retrieving 
the contents of the composition window. Put writes out the entire contents of the composition 
window onto the file whose name is inside the brackets. (If a file with that name already exists. 
Laurel requires an extra confirmation before overwriting it) Get replaces the contents of the 
composition window with the text contained in the file. As usual, if you click red over Get or Put, 
a blinking caret appears within the brackets and you may fill in or edit the file name before 
confirming the command, whereas if you click BLUE, Laurel will execute the command immediately 
using whatever name is already inside the brackets. 
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Put is useful when you want to save a partially-composed message to be completed and delivered 
later. You may also want to do this if you encounter persistent network or mail server problems upon attempting to 
Deliver. Get is also handy for obtaining custom forms (or form letters) that you have prepared 
previously. Obviously, you can use laurel to edit arbitrary text documents in much the same 
fashion as Bravo; however, since laurel docs not provide any of Bravo's formatting capabilities 
(multiple fonts, looks, etc.), you will find Laurel to be of limited utility in this respect 

In addition to the Get and Put menu commands just described, there exist Get and Put keyboard 
commands. These work somewhat differently from the menu commands. In particular, whereas the 
Get and Put menu commands operate on the entire composition window, the Get and Put keyboard 
commands operate only on the current selection. Get and Put do, however, make use of the file 
name contained in the Get, Put {file } menu command. 

The Put keyboard command first prompts you either to confirm the file name already in the 
brackets or to type in a new file name, then writes a copy of the currently selected text onto the file 
by that name. This text is not removed from the composition window. 

When you issue the Get keyboard command. Laurel first puts a copy of the currently selected text 
into the file name brackets. You may now either confirm that file name (with ESC or whatever) or 
type some other name followed by ESC. Laurel then replaces the currently selected text by the 
contents of the file, leaving the replacement text selected. 

The Get keyboard command can be used as a file substitution device anywhere within a composed 
message. To include the contents of a file within a message, insert the file name (including the 
extension) at the desired point. Then select the file name with the mouse buttons as you would for 
a Replace command, but type Get ESC instead of Replace. Laurel will replace the file name with 
the contents of that file. 

It is sometimes useful to expand a distribution list before sending a message. You can do this by inserting the 
distribution list name in the appropriate header field, selecting it. then typing Get. In addition, there is a short-cut that 
permits you to omit the explicit ".dl" extension. If you type the file name followed by a "t”, select it, and type Get, 
Laurel will append the ".dl" (if no extension is present) and perform the Get You may take advantage of this feature 
to peek at the contents of a distribution list; use Gel as just described, then undo the expansion by typing Undo. 

Put produces a file that can be read and manipulated by Bravo. In Tact, you can create a Bravo document, use the Get 
keyboard command to read it into a composed message, then send the message. The recipient can perform a Forward to 
move the received message into the composition window, select the portion or the message consisting of the Bravo 
document, and issue the Put keyboard command to write it onto a Tile. It should be noted that Bravo formatting 
information in the document may contain unprintable characters, which are displayed by Laurel as black rectangles 
However. Laurel does not actually alter these characters, so formatting information is not lost. You must take care to 
Put the entire Bravo document (and nothing else), or else Bravo won’t be able to read it. 


Message header format 

laurel supports a subset of the Arpa standard for message headers (RFC 733/NIC 41952). Happily, 
users need not be aware of most of the requirements of this extensive standard. However, two 
features should be noted. First, comments may be included in a header item by surrounding them 
with parentheses. Second, recipients at Arpanet sites other than Parc-Maxc may be specified as 
either "name @ site” or "name at site". 



You should avoid typing extra CRs in message headers, since the arpa standard specifies some less- 
than-obvious behavior in such cases. In practice, this is rarely a problem, because Laurel will 
supply line breaks for you (both on the screen and in the transmitted message). 
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33. Authentication and logging In 

In order to perfonri New mail, you must be an authenticated user. This means your name and 
password must be accepted by a centralized authenticator (currently Maxc). When you start up Laurel, 
it obtains your name and password from the Alto Operating System and submits them to die 
authenticator for verification. If the authentication fails, the message "Name or password invalid" 
will appear in the upper menu, just below the Laurel version number. Laurel will not allow you to 
receive messages until you have been authenticated successfully.. 

To enter a new name and password, point the cursor at User in the upper menu and click RED. 
Laurel will invite you to supply a user name in the brackets following User. Respond as you would 
for other {brackets} prompts (see section 2.1). After you have entered your user name. Laurel will 
prompt you for a password in a similar way. You must supply the password explicitly— £SC, 
YELLOW, etc. cause a null password to be entered. Laurel will not display your password as you 
type it. A fine point: At present, the name you supply to the User command is used as the directory on Maxc where 
your mailbox is located. This may not be true in the future, but it will always be possible for Laurel to locate your 
mailbox from the user name you supply. 

Laurel normally requires that you be an authenticated user before it will allow you to receive or 
send messages. If, for some reason, you are not an authenticated user and you select Deliver, 
Laurel will prompt you for confirmation. If you confirm, Laurel will append the phrase "(not 
authenticated)" to the sender identification it includes in the outgoing message. This makes it 
difficult for others to masquerade as you (or vice-versa). 

When you leave Laurel, your name and password are passed back to the Alto Operating System. 


3.4. Polling for new mail 

Laurel checks your in-box periodically to determine if new mail has arrived. If it finds messages 
waiting in your in-box, it stops polling and displays "You have new mail" below the Laurel version 
number at the left-hand side of the upper menu. You may then use the New mail command (see 
section 2.4) to move the messages in your in-box to the current mail file. After you have done so. 
Laurel will remove the "You have new mail" message and resume its periodic polling. 

Because this polling is completely automatic, you can leave your Alto running Laurel when you are 
not using it for other things, and glance at the screen occasionally to see if new messages have 
arrived. The polling interval at present is about 5 minutes. 


3.5. Command line options 

>'» Laurel has several command line options that can be specified when you invoke it from the Alto 

0 Executive. 

Km 

1 as 

Mail file selection 

viS- Laurel’s default action, triggered when you type 

> Laurel CR 

is to perform an implicit Mail file on Active.mail. If you type 
> Laurel filename ^ 
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Laurel will read filename. mail instead. If you supply an explicit extension. Laurel will respect it 
otherwise it will use ".mail". F ^ 

In-box interrogation 

You can also request that Laurel access your in-box automatically when it begins execution. Type 
>Laurel/n__ or > Laurel/n filename < ~' R 

Laurel will first perform an implicit Mail file on the indicated or defaulted file (see above) It then 
will check to see if messages are present in your in-box. If so. Laurel performs an implicit New 
mail. Upon the completion of the New mail (if any). Laurel is available for nornial use. 

You may also invoke Laurel by 

> Laurel/c CR or > Laurel/c filename CR 

f messages are present in your in-box. Laurel will behave as though "/n" were specified. If no 
new mail exists. Laurel will omit the implicit Mail file and return directly to the Alto Executive a 
fine point: if Laurel is unable to determine whether your in-box has messages, it ignores the /c switch. 

Send message mode 

k begi^exS^ 'jype y ° U may reQUeSt 11131 ^ ureI omit its ™plicit Mail file when 

> Laurel/s CR 

Instead of reading a mail file. Laurel will perform an implicit New form as it starts up You mav 
then compose and deliver your message in the usual, way. If, after doing so, you wish m process a 
mail file, simply invoke Mail file and supply a file name as described in section 24 


3.6. The Laurel profile 

Laurel obtains certain configuration information and options from vour laurel nrnfile • 

file Laurel.Profile on your Alto disk. A standard Laurel profile S Sled wheHmf nS ? "! 

using the LaurelNewUser.cm or Laurel.cm command file ^section 2). The only things in the iJmel 
pro i e you are likely to want to change at present are the name of your printing server and nerhans 

documented here C ° Py 0miat ° Pti ° nS ' F ° r completeness > however, nearly all possible options are 

Latrrel.Profile is a text file containing a sequence of parameter lines , each of which has the following 
name', value ^ 

must adhcr f to this format. This implies that there may not be any blank lines 
m the file. Furthermore, the last character in the file must be the cr of the last parameter W 

tharUurel^r' 08 "w pei ™ lU ed. You should P™bably use only Laurel to edit Laurel.Profile Note however 
and resJrt SumTbef ^ ^ *° aftcr ediUnfi LaurclPr ° nie >«i must Quii 

=s ajwf&sus 

The value may be preceded by any number of blanks and begins at the first non-blank character 

s « q r incl,,aed in u,e ^ ^ ^ 

A typical Laurel.Profile for use at Parc might be as follows: 
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Send: Maxc 
Retrieve: Maxc 
Authenticate: Maxc 
Hardcopy: Clover 
PrintedBy: $ 

Parameter names may be spelled in upper or lower case or in any combination. This example 
leaves out many possible parameter lines. Parameters that are missing from Laurel.Profile are given 
default values by Laurel. 


Send: host name 

The name or network address of the mailbox server machine to which you will send all outgoing 
mail. (Default: Maxc) Network address constants of the form number# number# must be used at sites where there 
is no gateway providing name lookup services. 

Retrieve: host name 

The name or network address of the mailbox server machine from which you will retrieve new mail. 
(Default: Maxc) 

Authenticate: host name 

The name or network address of your authentication server, i.e., the machine that verifies user name 
and password combinations. (Default: Maxc) Normally the values specified for Send, Retrieve, 
and Authenticate will all be the same. 

Hardcopy: host name 

The name or network address of the hardcopy server machine to which all hardcopies will be sent 
(Default: an illegal server name) 

PrintedBy: text 

A line of text that will be printed on hardcopy break pages to identify the person making the 
hardcopy. Any "$” characters will be expanded to your logged-in name at the time you generate 
the hardcopy. (Default: $) 


Herald: text 

A line of text to be printed at the top of the first page of each hardcopied message. (Default: Inter- 
office Memorandum). You should take care to ensure that the herald will fit on one line when 
hardcopied. 

• 

HeraldFont: font 

The font that will be used to print the herald on hardcopied messages. A font value must take the 
form: 

family-name point-size face 
Examples: 

TimesRoman 14 B 

Helvetica 10 , ¥ . , _ . .. , . 

The optional B or I following the point size indicates bold or italic face. If the CR immediately 
follows the point size, the regular face is used. (Default: TimesRoman 12 B) 
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Logo: text 

A line of text to be printed at the logo position between the header and the message body on the 
first page of each hardcopied message. (Default: XEROX). You should take care to ensure that 
the logo will fit on one line when hardcopied. 

LogoFont: font 

The font that will be used to print the logo on hardcopied messages. The format for the font value 
is given above under HeraldFont. (Default: Logo 24) 


4. If things go wrong . . . 

In Laurel, as in most interactive systems, lots of things can go wrong. Also as in most systems, 
some of them are your fault and some of them are not. Laurel tries to prevent you from wreaking 
destruction upon your environment, and reports any (perceived) violations in the feedback region. 

The error reports in the feedback region are intended to be self-explanatory. If you cannot figure 
out what one means or what to do next, please send a message to LaurelSupport (using Laurel if 
possible). 

If Laurel detects certain internal error conditions, it interrupts whatever command was in progress and posts a message in 
the feedback region. In some cases, Laurel may decide that the error should be reported to LaurelSupport, and, in such 
cases, it will prepare an error report form (after confirmation from you). This form contains internal status information 
of interest to the Laurel implementers and should be used whenever possible. If you confirm the use of this form. 
Laurel will restart itself and display the form in the composition region. You should then follow the instructions contain 
within the form, after which Laurel will again be available for normal use. 


5. Laurel and MSG 

This section addresses the relationship between MSG and Laurel. As mentioned in section 1, MSG 
users must thoroughly understand the contents of this section before trying to use Laurel for the first 
time. If you don’t use Maxc or you have never used MSG, you may skip this section entirely. 

Before proceeding to the gory details, we should remind you that these comments apply only to 
Laurel versions 1 and 2. Most of the difficulties described below are artifacts of a temporary 
implementation of a number of Laurel facilities. Future releases will cure these ills, so if Laurel 
appears insufficient for your present needs, don’t give up. 

Mail files 

Laurel keeps nearly all of its files on your Alto disk. The only exception is your in-box, which is 
currently file Mcssage.txt in your directory on Maxc. Getting new mail (with Laurel) moves 
messages from Maxc to your Alto disk, emptying Message.txt. TTiis makes it very inconvenient to 
continue to use both Laurel and MSG, and it makes Laurel inconvenient to use if you switch Alto 
disks frequently. For now, our best advice is to designate a disk on which you will use Laurel 
exclusively, and stick to it You will need about 500 disk pages to hold Laurel (including 
RunMesa.run), a moderate-sized mail file, and several distribution lists. 

Once you have mail files on your Alto disk, it becomes impossible to process them using MSG, 
since they are on the Alto. Furthermore, Msg and Laurel maintain mail files in formats that are 
incompatible. You can continue to use MSG to maintain mail files on Maxc, and you can use 
Laurel to maintain mail files on your Alto, but you cannot move mail files back and forth. If you 
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are willing to convert completely to Laurel, you can move MSG-constructed mail files to your Alto 
for use by Laurel, as explained below. However , this is a one-way street; once on your Alto the files 
cannot conveniently be moved back to Maxc and processed by MSG. If you are not willing to convert 
completely, we recommend that you wait to use Laurel until it is able to deal with remotely-stored 
mail files. 

On the positive side, your correspondents never need to know that you have converted to Laurel, 
since Laurel is able to process your Mcssage.txt file directly. All that has happened is that you have 
started using that file in a different way (as your in-box), but the change is invisible to people who 
send you messages. 

Mail file philosophy 


:ems, 

caking 

region. 


Laurel encourages you to use your default mail file (Active.mail) as a temporary storage area, not an 
archive. Accordingly, deleted messages are expunged whenever you leave Laurel or shift your 
attention to another mail file. There is no analogue of MSG’s Quit command (which preserves 
deleted messages); Laurel’s Quit is like Msg’s Exit. If you wish to classify messages, use mark 
characters (section 3.1). Eventually, selective display on the basis of mark characters may be 
possible. Use separate mail files to obtain an archive facility. Laurel’s performance will be better 
and your screen will be less cluttered. 
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Overwrite 

Laurel doesn’t have a command corresponding to Msg’s Overwrite. However, the same effect can 
be obtained by selecting Mail file with BLUE. After you have read sections 2.4 and 2.5, it should be 
evident to you why this works. 
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Processing your mail away from an Alto 

You can use Msg from any reasonable terminal dialed to Maxc or connected to the Arpanet, but 
you can’t use Laurel without an Alto. Consequently, if you have no Alto available and would like 
to process your mail, you must use MSG. If you observe a few conventions while using MSG, you 
will not need to reprocess your old messages with Laurel. Thus, you can use MSG from a home 
terminal or when you are out-of-town, and revert to Laurel when your Alto is again at hand. 

As long as you manipulate only your Message.txt file with MSG, Laurel will note what you have 
done when you perform a New mail command. (Remember, Laurel uses Message.txt as your in- 
box.) Specifically, deleted messages in Message.txt will appear with lines through them (i.e., marked 
as deleted), and the examined/unexamined status of each message will be reflected in the mark field 
in Laurel’s table-of-contents entry. 
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Moving mail files from Maxc 

Because Msg and Laurel have incompatible mail file formats, you cannot simply move your 
archival mail files to your Alto disk and expect Laurel to read them. The following (admittedly 
tedious) procedure should be followed for each mail file: 

1- On Maxc, append the desired mail file, say Archive.txt, to Message.txt: 

@ Append Archive.txt Message.txt CR 

2. On the Alto, in Laurel, click red over Mail file and supply the file name "Archive". 





3. 


4. 


Select New mail. After the messages have arrived, ensure that no unexpected ones have 
been included at the beginning and/or end of the file. (New mail might have arrived 
on Maxc before or after step 1.) Move any extraneous messages to "Active.mail". 

Quit Laurel and go back to Maxc for the next file. 

Maxc at this point 


You may delete Archive.txt on 


rrr eI , y ,’ 0nce y0U h ? ve moved a11 of y° ur file s in this way, you won’t have to do it again since 

Laurel will maintain them in its own format on your Alto disk. 

6. Look before you leap . . . 

As you become familiar with Laurel, you will doubtless discover features that please vou and 
features" that annoy you. This section reports some of the annoying "features” other userelTve 
encountered and, in some cases, what to do to get around diem. 

Formatting messages for non-Laurel users 

Laurel breaks lines in a transmitted message by a rather simple-minded algorithm This mav lead 

If ™ v°T n ?h , when th r message 1S read on certain terminals using MSG (or other mail systems) 
If you know that some of your recipients have this problem, you may wish to exerci™care in^hc 
formatting of your outgoing messages. Use explicit CRs and keep your lines down to about 80% of 
Uurel screen width, (A relatively painless way to do this is to com^ tEe entire 

ETSTSSir ££f re ddivcr> ” ake 8 fl “>' - ~ -bs,i,„ti„ e g m cS 

Secondary selection from the message display region 

Soni"aut "rjUtSlaXsf “SpL h “ ^ T,™ donV^S 

£ r»ss are fjsh au? messa8e - you wm have rep, “ ***£$ 

Tabs 

Laurel does not presently implement true tabs. Instead, a tab is converted to a fixed ammmt nf 

22 ToTare o U ut if ofTucr ** 31 ^ beginning ° f 3 line ’ ^ wiI1 line «P 


The Answer form 

provided 012 Answer command is not always exactly what you might want Laurel 
£kes the viewpoint that ,t is easier to delete than to add text, and therefore inches alf the 

fiehT^f the that See F mS t0 be re u evant - For exam P le - Laurel often includes your name in the "cc" 
field of the answer form, even though you may not want a copy of the message you are comnosine 

a:rtL^°k ^con4fnf e ^e^deshed^infoiTnation W *^ * ** ^ “ * e headef *> be 

carefully whether or not it is appropnate for your reply to be sent to that distribution list, and if not 


Laurel Manual 


83 


delete the distribution list specifier. 


File version numbers 

Laurel does not support the use of Alto file version numbers. This restriction stems from the 
underlying implementation of the Mesa run-time system, and is not likely to change. Therefore, 
mail files and distribution lists should not have version numbers. 


Space required for mail files 

Some users, when converting from MSG to Laurel, have had a rude shock when they transferred 
their archival mail files from Maxc to their Alto disk. Recall that one Maxc disk page becomes four 
Alto disk pages when a file is moved. This is another reason for dedicating an Alto disk to mail 
processing and filing, particularly if you maintain archival mail files. 


Hardcopy usage 

Laurel’s Hardcopy command is intended for use in printing copies of isolated messages that you 
may wish, for whatever reason, to obtain in hardcopy form. It is not suitable for obtaining 
hardcopy archives of all your messages, say, to put in your filing cabinet. Because Laurel prints 
each message on a separate page, using Laurel hardcopy for such archival purposes would produce 
unwieldy quantities of paper. 

If you do wish to maintain a hardcopy archive, we recommend that you use the Em Press subsystem 
to print your mail file as continuous, unformatted text. 


7. Things a casual user doesn’t really need to know 

Laurel currently executes almost exclusively on your local Alto. Eventually, a large fraction of its 
facilities will be provided remotely in a transparent fashion, but for now everything except in-box 
storage is local. This means that all mail files reside on the local Alto disk. For each mail file x , 
Laurel creates a separate file .x-dmsTOC, which holds various internal information about the table-of- 
contents. When you invoke Mail file {x}. Laurel will recreate this file if necessary. Naturally, this 
slows down the Mail file command. 

Laurel creates scratch files while it is working and leaves them on your Alto disk. You may delete 
these files (named DMS-n.TMP for various values of n) if necessary, though Laurel ensures that they 
will not grow very large. Deleting them lengthens the time required to start up Laurel. 

If Laurel generates an automatic error report directed to LaurelSupport (see section 4), it will leave 
behind a file Laurel. BugReportS containing the text of that report. You may delete this file if you 
wish. 

In-boxes are not stored locally. Laurel assumes that your in-box resides on the server machine 
indicated in the "Retrieve" line of your Laurel profile, and uses that machine’s mail server to read 
and empty them. Messages sent via the Deliver command are forwarded to the mail server 
specified in the "Send" line of your Laurel profile. Arpanet addresses, specified as "name @ site" or "name 
at site . will work correctly only in messages delivered to Maxc. All this is Strictly temporary — eventually. 
Laurel will understand about mailboxes in multiple places and will introduce its own notions about 
naming message recipients. 
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1. Introduction 
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3. Use of Markup 
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This section of the manual starts by explaining how to get hold of a copy of the Markup program, 
and how to get the program running. It then covers each of the commands of Markup, one by one. 
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How to obtain Markup 

The program you need is called Markup.run, and is to be found on the <Alto> directory on Maxc 
and on most Ire servers. A copy of Markup.run is usually included with the other programs on the 
Basic Non-programmer'S Disk. If your disk docs not include a copy, transfer it from your local 
file server by means of the Ftp program; for example: 

> Ftp Maxc Ret <alto>markup.run CR 


How to start Markup 
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Simply type "Markup", followed by Markup will ask you for names of the input and output 
files. If you omit the input file name, and type only Markup will supply a one-page blank 
Press file; if you omit the output file name. Markup will assume that you just want to play, and do 
not want to generate any output for printing. For convenience, you may type both file names on 
the command line: 

> Markup InputFile OutputFile CR . 

Markup takes several seconds to get started. Eventually the display screen will go blank, the first 
page of the input file will appear, and the cursor will change to a small cross. Markup is now ready 
for your use. 
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If the input and output file names are the same. Markup will save the original input file on a backup file whose name is 
the original file name followed by "$". This operation is performed at the time you "quit" from Markup. 
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The mouse 

The mouse is the most important input device to Markup. Its three buttons are used throughout in 
a consistent manner: 

RED button (top or left-hand): use of this button generally results in the addition of 
information to the document 

YELLOW button (middle): this button invariably controls the display of the command mem 
that you use to select your next command. 

blue button (bottom or right-hand): use of this button generally results in the removal of 
information from the document 


There are exceptions to these rules, which are noted below wherever they occur. 

As a minor but important point, it should be understood that the so-called "ball mouse", with the 
three large buttons arranged from left to right is much less satisfactory for use with Markup than 
the older-style mouse with three bar-shaped buttons, arranged from top to bottom. The old-style 
tnouse can be moved much more smoothly than the ball mouse, and this is essential for some of the 
freehand drawing operations of Markup. 



the yellow (middle) button, one row of the command menu appears. You 
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Figure 1. The Markup menu. 
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if you press, and then move the cursor about 1/4 inch, a line segment will appear. As you move the 
mouse further, a connected sequence of line segments will be laid down, following the path of the 
cursor as closely as the grid will allow. Note that as long as the button is held down, the corners of 
connected lines are filled in neatly; if you lift the button between line segments, however, the 
comers will look messy. To rectify this, you can redraw the line segments that meet at the comer 
in question. 

At the start, Markup sets the line drawing grid to 16x16 Alto screen dots. If you are a novice, you 
will find this relatively large spacing convenient, but for many purposes it is too coarse — 8x8 is a 
more useful setting. The command for changing the grid setting is described below. 
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Text 

To add text to your picture, simply type it. You need not position the cursor before you type, for 
Markup expects you to position the text afterwards. While you type, the text will appear wherever 
the cursor happens to be. During type-in, a c or BS erases the most recent character typed, and DEL 
or either the yellow or blue mouse button erase the whole string. When the text is complete, 
position the cursor where the center of the text string should go, and press on the RED button. The 
original text will disappear from the screen, and will reappear, centered about the cursor position. 

Text is positioned in this way to the nearest half-grid unit. If you want to position it more 
accurately than that, do not release the RED button immediately, but hold it down and move the 
mouse in the direction you would like to move the text. You will have to move through a small 
"dead zone", and then the text will begin to move, somewhat more slowly than the cursor. If you 
move the mouse beyond a certain distance, the text will disappear altogether. This is useful, for it 
allows you to change your mind about inserting the text 

Text may also be erased, using the blue button. To do this, you must first select the "text brush", 
i.e. the T-shaped symbol in the lower right-hand comer of the menu. When you point at a string 
of text and press on the blue button, the text will be erased. It may now be inserted elsewhere 
with the red button. Only the text brush and the text-and-image brush (see below) can be used to 
remove text. It is not always possible to erase text created with other programs, such as Bravo or 
Draw. 

Markup "remembers" the text you erase, or type in and insert, and allows you to insert this text any 
number of times. In between insertions, you may draw with the freehand and line-drawing brushes, 
change fonts (see below), and move to other pages of the document 

You may add text in any of the fonts in the font portion of the menu. To select a font press the 
yellow button and move the mouse down until the font menu appears; lift up when the cursor is 
within the appropriate font name. You may change the font of a piece of text in this way: erase it 
switch fonts, and insert it 


Image areas 

Markup provides a number of commands for manipulating rectangular image areas on the screen. 
You can erase an area, insert its contents somewhere else, rotate the image, make a mirror image, 
and scale it up or down. You may read in images from files on your disk, and may scan images in 
using a TV camera. You have the option, when erasing or moving an image area, of taking the text 
within the area too. 

In order to use all these commands, you must understand that Markup can "remember" image 
areas, in much the same way that it "remembers" text. Thus when you erase an area, it doesn’t 
vanish forever, but goes into Markup’s memory; when you give the command to insert an image, it 
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Images and text 

At the left-hand end of the bottom row is a symbol made up of the image area and text symbols 
combined. If this symbol is selected, text and image areas can be manipulated together This 
command is very useful for moving entire illustrations. 

The image-and-text command works in a similar fashion to the image area command' the BLUE 
button is used to define the rectangular area to be picked up, and the RED button is used to insert 
the image and text in the desired position. As in the image area command, a rectangle shows where 
the information will be inserted; also the same cursor alignment feature is available Images and 
text may be moved between pages by erasing them, selecting another page, and inserting them' this 
is useful for adding existing illustrations to a text document, and applies to pure images and nure 
text as well as to combinations of the two. 

The only unusual feature of this command is its criterion for picking up text Any text strings 
placed on the page with the aid of Markup will be picked up provided they lie within the boundary 
of the overall enclosing rectangle. Formatted text from Bravo, however, is picked up only in units 
of a paragraph at a time— it is not possible to pick up part of a paragraph and leave the rest This 
is sometimes useful, for it means that you can pick up an illustration without accidentally including 
part of a nearby text paragraph. e 


dary of the 
H move this 
to add the 
; you may 


-until this 
he screen, 
if the image 
sor over the 
Now you 
'ou where 
RED button. 


Changing the grid 


The symbol resembling a number-sign, next to the image-and-text symbol, can be selected in order 
to change the grid spacing. This command uses the BLUE mouse button for size changes and the 
RED to change the grid alignment Either button, if pressed, will cause lines of dots to appear on 
the screen showing the horizontal and vertical grid spacing. 


To change the grid spacing, press down on the BLUE button. Two numbers will appear near the 
cursor, showing the horizontal and vertical spacing. As the mouse is moved, the spacing will 
change. It can be adjusted to as high a value as you like, and to as low as 5 units in each direction, 
independently in the two directions. Note that 45-degree lines cannot be drawn if the horizontal 
and vertical spacings are different 


4 t> 

•w 

nbol can be 
‘xactly like 


displayed 



You may wish, after changing the grid spacing, to make sure that lines drawn with the new grid are 
thos ^ drawn previousiy. To do this, you may have to change the grid alignment, using 
tne RED button. When the red button is held down, two numbers show the coordinates of the grid 
origin',' you can think of these numbers'as defining the position of the "squared paper" on which 
tne grid is drawn. With the aid of these numbers, plus the dots showing the grid itself it is usually 
possible to get things lined up. ’ J 


Inversion and fast erasing 


TTie bottom row includes a command symbol made up of a black box together with an open box 
i ms command provides two functions. With the RED button, image areas may be inverted i e 

mack dots turned white and vice versa. With the BLUE button, fast erasing can be done at the 

T £ ° f neval from mistakes— once the dots have gone, they can’t be retrieved or inserted 
vnn ™ lf you should ever need to erase a large area rapidly, you will find this command saves 

y many seconds of waiting. This command operates only on dots, not on text 
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Turning the page 

The numbers to the left and right of the main menu may be selected in order to turn to other pages 
of the document. Markup’s memory is not affected by page turning. The " + " symbol creates a 
fresh blank page. There is no command for erasing a page, but if all the text and dots on a page 
are erased, Markup will delete the page from the document when it writes out the output file. 

Finishing 

When you have finished using Markup, select the word "quit" to the right of the page number 
display in the menu. Markup will think for a while, and then return you to the Alto Executive. 

Camera input 

The menu contains a few blank spaces, including two on the third row. However, if you happen to 
use an Alto with a TV camera attached, a special symbol will appear on this row, depicting a square 
with a round hole in it. This symbol controls the use of the camera for scanning in images. 

Before you select the camera command symbol, you should define a rectangular area of the screen 
into which to scan the image; do this by erasing an area with the image-area or fast-erase brushes. 
Then when you select the camera command, the normal screen picture will disappear, and you will 
see instead the view through the camera lens, with an area of the required size highlighted within a 
black border. You can move the border around until it encloses the desired image, and then press 
the RED button to scan the image onto the page and return to the normal display. The mouse may 
be moved while the RED button is held down, in order to make accurate adjustments to the position 
of the border. 

The camera hardware performs what is known as thresholding on the image — dark areas are made 
black, and light areas white. The resulting image quality is not always perfect To improve it, you 
can adjust the threshold level while the camera image is visible, by pressing the blue button and 
then moving the cursor up and down: upward movement will darken the image, and downward will 
lighten it at a rate proportional to the cursor’s horizontal position. 

Use of the TV camera unfortunately involves learning how to switch it on, and how to adjust the 
various knobs on the camera control box. This is best understood by watching someone else do it 


4. Markup Techniques 

• 

or by i This section is for serious users of Markup, who want to learn how to produce good-quality 

in * 3 illustrated documents with the minimum of effort The list of techniques described here is by no 

t it ’i. .• i means exhaustive. After all. Markup is really a "box of tools" for manipulating the image on the 

i is screen, and there arc no well-defined limits to the utility of these tools. Each tool has an explicit 

hove. purpose, like line-drawing or area manipulation, but there arc generally several other useful things 

you can do with each tool; for example, you can erase with the line-drawing brushes in order to 
list * square off an irregular black area. The more you use Markup, the more techniques and strategies 

age k • -■ f° r illustration you will learn. 

ihibit -n,- 

this section deals with two sorts of technique: those for managing your document as a whole, and 
those for creating the individual illustrations. Document management techniques are discussed first 
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Disk space 

The first thing you must understand before trying to illustrate a large document (i.e. a document 
with more than half a dozen illustrated pages) is that Markup consumes large quantities of disk 
space. As a rule of thumb, you should make sure there are at least 100 free pages on your disk for 
every illustrated page of the document. Thus if you intend to put illustrations on 12 pages, you 
should have 1200 free pages before you start. The exact amount you will need depends on the size 
of the illustrations: if you intend to put just a few tiny images on each page, in the same manner as 
this manual, then your disk space requirements will be much less. 


The reason for all this caution is that Markup cannot be relied upon to recover gracefully if it runs 
out of disk space, unless it runs out after you have "quit". Whenever you turn to a different page. 
Markup checks to see if you have 100 or more disk pages available; if you do not, it writes out the 
pages you have created or modified so far, and quits to the Executive. This is not fool-proof, 
however, and it is still possible for you to spend three hours illustrating twenty pages, and then run 
out of disk space while working on the twenty-first, leaving you with no means of recovering your 
lost work When you "quit", Markup goes through a cleaning-up operation, combining the new 
versions of the pages you have created or modified with the original versions of the pages that have 
not been changed. This, too, consumes disk space in large quantities, but if Markup fills up the 
disk during this operation, or quits when it finds fewer than 100 disk pages, there is a simple 
recovery procedure (see below. Recovery from a full disk). 

For reasons such as these, it is generally worthwhile to split large documents into a number of 
separate Press files, and combine them only when all illustrations are complete. This is easily done 
with the PressEdit program (see the Alto Non-Programmer’s Guide or the Alto Subsystems 
Manual). Each separate Press file should include no more than six to ten illustrated pages. 

Use of existing illustrations 

Documents must often be edited many times before they are ready for distribution. Markup has 
been designed to allow you to prepare the illustrations for such documents on a separate Press file 
or files, and then to combine them with the text You may also use illustrations prepared with 
other programs, such as Draw, Sil and Flyer. 


This technique amounts to the preparation of one or more Press files that form a portfolio of 
illustrations for inclusion in the document It is generally more convenient if each Press file page 
contains just one illustration. If, however, you are sure that a certain group of two or more 
illustrations will be placed on the same page, then you will save time by keeping them on one page 
of the portfolio. 


The PressEdit program is again the means whereby the formatted text file (in Press format) is 
combined with the portfolio file or files. Once the files have been combined, you can commence 
the rather tedious operation of copying illustrations from the portfolio pages to the appropriate text 
pages using the image-and-text brush. Make sure that, at the end, nothing is left on the portfolio 
pages, so that they will be expunged from the file when you write it out 


Use of Draw output 

Press files generated with the Draw program may be used as input to Markup. You may define 
curves with Draw, and then read the resulting Press file into Markup, in order to add image 
information or text 


Although Draw allows you to add text to the curved pictures you draw, it is often more convenient 
to omit the text at the Draw stage, and add it with Markup. If you include text in the Draw file, 
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you will find the resulting picture very slow to edit with Markup, particularly if you mix several 
fonts. 


For faster copying 

Markup uses a rather out-of-date method of copying image areas, which means that this operation is 
sometimes rather slow. In particular, if the grid is not set to a horizontal spacing of 16, with the 
origin at zero, then images will be inserted very slowly. Before you start copying illustrations from 
the portfolio to the text pages, therefore, make sure that the horizontal spacing and grid origin are at 
16 and zero. For ease of vertical alignment, however, you may set the vertical spacing to a smaller 
value, such as 8, without affecting performance. 


Recovery from a full disk 

If Markup exhausts disk space during during a page tum or the "quit" operation, it prints a 
message on the screen telling you what to do. In essence. Markup saves all the new and modified 
pages of the document on a Press file called MARKUP.SCRATCH, and this allows you to reconstruct 
the desired output file. 

The most difficult part of this operation is to figure out which pages are included in 
MARKUP.SCRATCH. You may use Markup itself to help you here, but with caution, for Markup 
erases markup.scratch and creates a new version. Therefore you should copy MARKUP.SCRATCH 
to a file with another name (such as FOO.SCRATCH), and look at this new file with Markup. When 
you have figured out which pages this file contains, you can use PressEdit to put together the 
required document out of this and the original file. Before doing all this, you must of course delete 
some files from your disk, so as create more space. 
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Introduction 


Draw is an interactive illustrator program for creating pictures composed of lines, curves 
and text captions. All the illustrations in this document have been created with Draw 
A ppendix C shows a few interesting examples. 


Illustrations are drawn on the Alto screen 
familiar with the use of this device should 
keyboard and mouse terminology). 


with the help of the mouse (the reader not 
consult Appendix A which explains standard 


Three types of actions are usually necessary for creating and altering pictures: 

- Selecting an operation or command to be executed by Draw. Most commands are 
selected by clicking in a command menu area of the screen. Some commands mav 
also be typed on the keyboard. 


-D efin jng points in the picture wich govern the drawing of a line, of a curve or 
the modification of the picture. These points are specified with the help of the 
mouse in the picture area of the screen. 

Selecting the brush to be used for drawing a line or a curve in the picture or 
selecting the font to be used for writing a caption. Brush and font are also selected 
by clicking in the brush menu area or the font menu area of the screen. 

As just mentioned, the Draw screen is divided into a number of areas: 


■- 

r 

| message area 


"1 

brush 

menu 





command 

menu 



picture 

area 


font 

menu 

1 

J 








z~z.~u 


caption area 


The picture area shows the current state of the illustration being composed. The menu 
areas contain symbols which serve to identify commands, brushes and fonts that may be 
selected. I he caption area is used to show typed captions destined to be added to the 
illustration. Finally, the message area is used by Draw to display informational error or 
prompting messages to the user. 
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1. Using the menu 


The menu is organized in three parts: 


/ 

/ 

/ 

/ 




Brush selection 


The "paint brush" used for drawing lines and curves may be changed 
by pointing in this area. The size and the shape of the brush may be 
changed independently. There are four different brush sizes (on the 
left side of the menu) and four different brush shapes (on the right 
side of the menu). Brush selection may be done at any time, 
regardless of the current selected command. This is done by clicking 
the chosen brush size and chosen brush shape. 



The current brush is shown here. 


© 


# 

A 

A 


+ 

X 

□ 

* 


Command selection 

All commands involving display interaction are in the central area 
of the menu. Each is represented by a small ideographic symbol. A 
command is selected by clicking the corresponding symbol. Draw 
indicates which command is selected by changing the shape of the 
cursor to match the command symbol. 


▲ 

A 


2 


3 


Font selection 

0 One of four text fonts (numbered from 0 to 3) may be selected by 
clicking the corresponding font number. The current font is shown 

1 on a black background. Font selection may be done at any time, 
regardless of the current selected command. 


When pointing at the menu, you may click any one of the three mouse buttons. 

A few additional operations, which do not involve display interaction, are invoked by 
control keys. They never affect the current selected command. 




2. Drawing a curve 

is def T d by a , , number of special points, called knots, distributed along its 
trajectory. The density of knots is generally a function of the curvature of the curve If 

look C iSg Ve iike n this ° Sed ’ US 6nd P0 ' ntS Wi " bC thC f ' m 3nd Iast knots ’ For instance - a cur ve 


could be defined by these 5 knots (shown as big dots): 


I " ° rd f to dra Y a similar curve . first select the command +. Then using the red button, 
click down 5 knots at these approximate positions: 
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One single knot makes a dot, two knots make a line: 

- ’ / 

In order to make a smooth closed curve, select the menu command ® , and then specify 
the knots by clicking red: 
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3. Text 


3.1 Text input 

Text captions are added to an illustration by typing on the keyboard. The caption being 
typed is displayed in the caption area located at the bottom right corner of the display 
area. Delete characters with the es key. To start over hit the rfturn key and type again. 

To put the text caption into the picture, invoke the text command by either hitting the 
REIUBN key or clicking the caption area itself. As a result, a short section of the text 
caption becomes the cursor and the text buffer is closed : the caption is displayed on a 
b ack background. This means that further keyboard input will start a new caption. 

You may now repeatedly deposit copies of the text caption in the picture area by clicking 
e red mouse button. If part of the caption lies outside the picture area, the text is not 
displayed but is shown as a striped rectangle of the same size. The very last deposited copy 
may be erased with either Ctrl a or eel. 


This is an example 


This is an example 
This is an example 


XEROX 


XEROX 


The text font may be changed at any time, using the lower area of the menu. The caption 
affected ^ Updated accordin S , >'- but text already deposited in the illustration is not 


3.2 Text positioning 

The truncated portion of the caption which appears as a cursor is used for easier 
positioning of the caption in the illustration. In order to allow either centering or 
ahgnment of a caption, the portion displayed may be either the beginning , the middle or 
the end of the caption. The effect is accomplished by setting the appropriate text 
positioning mode with £IRL_i, as illustated below. The options are: center, left, right top 
and bottom. The initial mode is center. ’ y 


This is an | example; 


left 


center 

bottom 

top 


right 
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3.3 Menu command ■!• 

If the central section of the caption is blank, or if the characters are too large, it may not 
be practical to display a portion of the caption as the cursor. Then it is probably 

preferable to use the T-like pointing symbol 7 \ This is done by selecting the text 
command in the menu area ( rather than by typing return or by clicking the caption area). 
Except for the cursor, the effect and operation of this command are as described earlier: 
point at some position in the illustration and click red. 

The position of the caption relative to the clicked point is a function of the text 
positioning mode. For example, if the mode is left, the clicked position will become the 
left edge of the caption: 


Left positioned caption 


Similarly for other positioning modes: 


Centered caption 


Right positioned captio'ri 


4. Redrawing and rewriting 


3 ion 
i not 


easier 
r or 
j • or 
-• text 
hi, top 



The shape of curves cannot be changed. However you can redraw a curve using a different 

brush. Select the menu command with a brush-like symbol JS. Redraw a curve, using the 
current brush, by pointing at the curve and clicking red: 



Remember that the current brush may be changed either before or after selecting the 
command J*. 

With the same command, you may also rewrite a text caption in a different font: 


XEffDX 


XEROX 




Draw Manual 


105 


5.2 Translating 


Selected objects may be translated with the command +. Using red, click twice with the 

tip of the arrow symbol ♦ to specify a source point P and a target point Q . The 
translated objects remain selected. 1 



l 

Qi 


The translation is defined uniquely by the length and orientation of the vector P Q . 
Therefore the two points may be arbitrarily positioned relative to the selected object!. 


5.3 Copying 


The command 
same fashion: 


is for making translated copies of the selected objects. It operates in the 
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5.4 Transforming: rotation and scaling 

"and “uffiST''”* ”> combination 

I, h " “ 0 p m p ati0 f n ,K Spec,fie< ? byf0Ur POintS (say P 1* P 2- Qi and Q 2 >- First define some 
f , 12 ° the ° riginal object ’ and then define the corresponding dimension Q,Q, 

ot the transformed object. The transformed objects remain selected Text is treated in l 
caption. Way ' " * Simp ' ! ' »» ^fotming IbelS'-m, TSt '.ext 






££ fmoThitogeriaoT o O vH"? by ,be mappi "S ° f “>« source 

vt . • * 2 . 1 1 get vector Q i^ 2- The four Points may be arbitrarily positioned 
and o n f W n ° r0tati0n if PjP2 and Q 1 Q2 are parallel > and no scal *ng if P,P, 

“tanstama’il eq nS ‘ h ' SeC "° n 9J ^ deta " S for «"» constrained 




The command 
objects. 


A 


is used in a similar fashion to make transformed 


copies of selected 
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6. Deleting 


To delete lines, curves and text, select the menu command Then, using red, click at 
the objects to be deleted. 




The keyboard command ctrl d will delete selected objects. Therefore, Ctrl e followed by 
ctrl d will delete the whole picture. 


7. Refreshing 


After deleting an object, the screen may not accurately represent the illustration, and will 
need to be refreshed. The inaccuracies result whenever one of several overlapping objects 
is deleted: a portion of an other object may also be erased. These effects do not affect the 
illustration itself, but only its current representation on the display. A new refreshed 
picture may always be obtained by hitting the tab key. This is a relatively fast operation 
which, like any other keyboard command, may be executed at any time. 


. 8. Undoing 

_ • 

There is a limited "undo" command for operations which are destructive or simply not 
easily invertible: delete , translate and transform. The command is ctrl u . It will undo 
the effects of the following commands: 


CTRL D 


X 


▲ A 


You may undo up to several levels of delete, translate and transform operations. The depth 
is a runtime variable which depends on availability of free storage. 
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9. Use of the mouse buttons 

« haS be “ described - "Ihourt all 

in the picture area. The mouse buttons are^,'e2 ?„ ™ a , nous '"“JWtations when used 
command. S are used ,n one of two « odes , depending on the 

9.1 Defining a point 

With the following commands: + 

of a cum 

defined by clicking one of the mouse hu.tonf'S^Vu.rSs'T'SereM'fSiU: 


»ED yields the exact location pointed at by the cursor. Click with the tip of * 
# A A A k. the center of + ® . the bottom of T. 

, L h°e W nei'rS poSl° 'the the' ^"“TV" obJm - Tl >“ il 

main applications are: ' ll,e ten,er of lhe nearest caption. The 

connecting cur»es: end knots of , m „ r „ „„ s0 „„ 


- = r r r: zr ™ 


ESI, b P, T''a ln • d '~tion 

translation points on this tine P y ne along this direction, and specify the 



blue is used to position a point on a grid. The grid which may be displayed and 
erased with the keyboard command Ctrl g . Useful applications are: 



used for 
a text 
! int is 
i ction: 


i if ^ 


i t will 
n. The 


:> ir line 



i, arrow 



text alignment 

left right 

justified centered justified 

text text text 



rotation 


scaling 



i (e.g. 
cify the 


slanting 


symmetry 
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9.2 Pointing 


^xt th camions rnm AI| d h H, * ^ R ’ th£ ™° USe ' S USed for P° fntin 8 at lines, curves and 
text captions. All buttons are equivalent. They may be used in two different wavs for 

designating either one single object or several objects enclosed inside some rectangular area. 

Pomting at one single object is simply done by clicking, that is to say nointine in the 
c m ity of the object and quickly depressing and releasing the button. P 


button down & up 


Designating several objects may be done by bounding a rectaneular area- Doint at nn P nf 


button 


pointing area 


out i 



button up 
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10. Saving and retrieving pictures 

Draw uses its own format for picture files. The recommended file name extension is 
draw. 

Two keyboard commands are provided for reading and writing picture files: 

CTRL w . followed by a file name, terminated by esc or return , writes the whole 
picture onto the file. So: 

CTRL W PICTURE-DRAW RETURN 

Ctrl R . followed by a file name, terminated by esc or return , reads in a picture 
from the file and adds it to the current picture. 

Thus a file "notebook" of elementary pictures may be constituted and utilized for 
composing complex pictures from simpler elements. 

The Draw file format is also accepted by the spline editor Fred (see documentation on 
<GR-DOCS>FRED.EARS). Therefore Fred may also be used to create pictures to be 
incorporated in Draw illustrations. However FRED ignores text and curve brushes, and 
need only be used for making complicated curves requiring careful editing. 
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11. Printing 

Draw pictures may also be printed and merged into documents. For that purpose. Draw 
outputs one single page PRESS file (the recommended file name extention is PRESS). The 
command is ctrl p . For instance type: 

CTRL p PICTURE-PRESS return 
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12. Fonts 


HELVETICA I'Ib) 1156 Furthermore A for better Stand f d namin 8 conventions (e.g. 

AHo/Ears fonts. ’ printing results you should use coordinated 

DRAW currently user a default font se, which is read in when the progratn is started: 

HELVETICA 12 (standard size) 

HELVETICA"! 2B (bold) 

HELVETICA8 (small size) 

ARROWS 10 (see Appendix B) 

followed by ha a nge fon 0 t n namf ^“nce, faiT? wkh: f ° m ( ° l ° 3) * 

£ F RL F . 3 LOGQ24.AI RETURN 

m „ m a r IS ° a f0,U ,Kl corresponding storage space, hy „ m i„i„g a,. 

GIBL_E 3 RETURN 


13. On-line documentation 


documentation ) WI The a manuaMs activated id?' *?•" a ^ stracled version of the present 
are obtained by hitting the i key disact.vated w,th cirl^. Consecutive pages 

5“* T d «.d restored. The 
take a quick look-- so to sDeak-- at th; c c l ^ e commanc * s * Therefore you may 

Picture. A prinmble P version of tbe^l , S a " y ^ without V™? 

<ALTODOCS>DRAW-SUMMARY.EARS. summary may be found on 



14. How to run Draw 


( eg Get the file package <ALTO>DRAW.DM and unpack it with the Alto program LOAD. It 

rdinated contains the following files: 

DRAW. RUN: this is the illustrator, 

tarted: , „ , . 

MANUAL! .DRAW to MANUAL13.DRAW: 13 pages of on-line manual, 


default fonts (see above), 


CIRCLE. DRAW: contains a carefully done 8-knot closed curve which impersonates 
a circle very well (look at it in sections 2 and 5.5). 

If you only need the program DRAW. RUN, the current version may simply be obtained 
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15. Summary of commands 


15.1 Menu commands 


lit oJr“L"rT„«tc,i?„ d rrTxTertncTuS ‘ n, ° ked from ,h ' k '» bM ' d - ™‘ 


menu equivalent action 
command keyboard 
command 


draw curves & lines 


draw closed curves & lines 


redraw curves & lines, rewrite text 
dash/undash curves & lines 


CI. PL X 


delete 


CTRL S 


CTRL Z 


translate 


CTRL C 


copy & translate 


transform (4-point) 
copy & transform (4-point) 
transform (6-point) 
copy & transform (6-point) 


position text 


text b etur n position text 

buffer 
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15.2 Keyboard commands 


delete last mouse input 
(applies to: + ® T 


start over 
(applies to: 


+®t*#aAa& 


CTRL T 


delete characters in caption area 
change text positioning mode 


refresh the picture 
display/erase the grid 


delete current selection 
select everything 


(applies to: ctrl d 


X i i A) 


write a picture file (Draw format) 
read a picture file (Draw format) 
write a Press file 


ctrl f n change font n 


enable/disable on-line manual 


get next manual page 


CTRL o quit 
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Appendix A 

Mouse and keyboard terminology 


The mouse 


The three mouse buttons on a mouse are labeled red, yellow and blue The Dhvsieal 
arrangement of the buttons depends on the model: Physical 



.. YELLOW .. 


/ N 

4 . 


Ul e tr n ?° st “7®" interaction with the mouse is the click: the mouse is first moved over 
snnf U nn e (h ntl the cur ^ or ’ wh ' ch follows the mouse movement, is positioned at the desired 
? n , the s ^. reen: then a button is depressed and raised in one motion Commands 

"n^nr be a d . m th,S manua ! usual| y call for clicking a particular mouse button, for instance- 
point at a screen position and click red". 

The mouse may also be used to bound a rectangular area which the user wishes to define- 
f.rst position the mouse at one of the corners of the rectangular area and depress a mouse 

button The r m0Ve t ^ t0 the °PP os,te corner and release the depressed mouse 

is “nimpodalt V ° the CUrS ° r betWeen the two corners of the rectangle thus defined 

The keyboard 

In this manual keyboard keys are given in underlined small size capitals eg o The 
special dark colored keys are identified by their keyboard label: 

ESC, IAB, C TRL , SHIFT . LF, DEL . _Bg, RETURN 


The ciRL and shjft keys are used similarly to the shift key on a typewriter. For instance 
CTRLA means: depress the ctrl key; depress and release the a key; then release the GIRL key.’ 
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Appendix B 
Arrow head font 


physical 


There is a special font of arrow heads for use with various illustrator programs (Markup, 
Draw, Sil). The Alto and Ears versions are: <ALTOFONTS>ARROWS10.AL and 
<FONTS> ARROWS'! O.EP. 

The arrow heads come in 8 directions, 4 sizes and 2 styles: 


* 

* ► 
- A 


A 


A A 


▲ A 


> 1 over 
esired 
norlands 
instance: 


jefine: 
a mouse 
J mouse 
;fined 


a. The 


tance, 
..j. key. 


The keyboard mapping is as follows: 

- the arrow heads occupy the left 8 keys of each row; 

- direction = counterclockwise, from left to right: 



size = row: 


A 


top row 


bottom row 


- style = lower case & upper case: 

"SHIFT V" is V* 

- reference key: 


"v" is ▼ (however, "<" is A ...) 


) 
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Appendix C 
Examples 


cents/bit 
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Appendix D 
Recent changes 


This section describes some features that have been added to Draw since the Draw manual was 
last revised. Some of them are experimental and may not remain in future versions of Draw. 


Freehand drawing 

Lines and curves can be drawn freehand, as an alternative to specifying line end-points or knots. 
To go into freehand drawing mode, pick up with the cursor the brush symbol shown in the menu 
inside a small square. Then draw on the screen in the usual way: press a mouse button, move the 
mouse around, and release the mouse button. The trajectory of the brush-cursor is painted on the 
screen as you move along. Rut when you have finished, the trajectory is erased and replaced by a 
smooth curve fitted through knots that have been automatically selected along the trajectory. Some 
smoothing of the trajectory is done in order to eliminate irregularities (due mainly to the mouse). 
The curve now behaves like any curve. 

Draw tries to help you in two ways: 

If the trajectory that you draw seems to have little curvature, it will be replaced by a straight 
line rather than a curve. 

If you use the grid button (blue). Draw will force the trajectory (and thus the resulting line 
or curve) to start and end on a grid point 

These two features should help in drawing horizontal and vertical lines on the grid mesh: boxes, 
rectangles, diagrams, etc. 

Color 

Draw permits you to introduce color into pictures that are to be printed on a color printer. 
Curves, lines, and text can be in black or in one of six basic colors: yellow, magenta, cyan, red, 
green, and violet (actually a dark blue). 

Eight commands in the menu pertain to color. Seven of them are tags representing available colors, 
each identified by a single letter (B, Y, M, C, R, G, v) inside a small circle. The color commands are 
used in two ways. Simply clicking a color tag selects the current color in the same way the current 
brush or current font are selected; all objects that you draw subsequently will be in that color. You 
can also pick a color tag from the menu apd then click RED over each object you want to assign 
that color. 

If you click the COLOR OFF menu command, it will change to COLOR ON, and every object in the 
picture will have a tag attached to it showing its color. 

Command line parameters 

You can specify a number of parameters in the command line that you use to invoke Draw. Each 
parameter consists of a decimal number, followed by "/", followed by a letter. Default values are 
used when the parameters are omitted or if the values you supply seem unreasonable. 
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Parameter Specifies 

n/S The maximum number of splines (curves and lines) that a picture can 

contain. The default is 200. 

n/K The maximum number of knots a curve can have. The default is 100. 

n/T The maximum number of text captions that a picture can contain. The 

default is 100. 

n/G The grid spacing, in Alto screen units. The default is 16. 

n/D The length, in screen units, of line segments in dashed curves and lines. The 

default is 16. 

n/O The length, in screen units, of omitted line segments in dashed curves and 

lines. The default is 8. 

Example: 

> Draw 250/S 50/K 8/G CR 
The user profile 

Your user profile (file User.cm) may contain a Draw section supplying settings for Draw. First, 
you may include up to four font definitions that determine the fonts available in the menu for text 
captions. A font definition has the form 

FONT:/j font-name 

where n is the font number (0 to 3). If you do put any font definitions in your user profile, then 
only those fonts are used by Draw; if you don’t include any font definitions. Draw uses a standard 
set consisting of Helvetical2, Helvetical2B, Helvetica8, and ArrowslO. 

Second, you can define the actual thickness of the four sizes of brushes Draw uses to paint lines 
and curves. A thickness definition has the form 

LINEWIDTH:/! width 

where n is a number identifying the brush (0 to 3 from top to bottom in the menu) and width is 
half the thickness of the line in micas (one mica is .001 cm or 1/2540 inch). The default thicknesses 
for brushes 0 to 3 are 16, 32, 64, and 128 micas. 

An example of a reasonable user profile section for Draw might be: 

[DRAW] 

FONT:0 Helvetical2 
FONTil Helvetical8 
LINEWIDTH :3 200 


''an 
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1. Introduction 

nmJam File . Transfer Program for moving files to and from an Alto file system. The 

program has three mam parts: 

1. An Ftp Server, which listens for file transfer requests from other hosts, 

2. An Ftp User, which initiates file transfers under control of either the keyboard or the 
command line, and 

3. A User Telnet for logging into a remote host using the Pup Telnet protocol. 



/./ Concepts and terminology 

JnnnlrS 8 \ file fr ° m ° n f ™ ach ' ne < or hosl ) to another over a network requires the active 
cooperation of programs on both machines. In a typical scenario for file transfer, a human user for 
a program acting on his behalf) invokes a program called an Ftp User and directs it to establish 
contact with an Ftp Server program on another machine. Once contact has been estobfished S 
FiP User initiates requests and supplies parameters for the actual transfer of files which the User 
Pt-p [If- P . rocecd t0 . “H.y oat cooperatively. The Ftp User and Ftp Server roles differ in that the 

n p User interacts with the human user (usually through some sort of keyboard interpreter) and 
the initiative m user/setver Intentions, whereas the Ftp Server plays CmpS, pLTve 

^f, qu , estion of w f h ich machine is the Ftp User and which is the Ftp Server is entirely independent 
, direction 0 f file transfer. The two basic file transfer operations are called Retrieve and Store 

ss a Ts“ a to move from w 10 u “ r - whereas s, ° re ~ 

The Alto Fn> subsystem contains both an Ftp User and an Ftp Server running as independent 
processes. Therefore, to transfer files between a pair of Altos, one should start up Ae S 
subsystem on both machines, then issue commands to the Fip User process on one machine 
directing it to establish contact with the FTP Server process in the other machine Subsequent file 

e " Urel> fr0m ““ ^ User "° intervention requiretfat 2e 

n^TcTT)'L! ll nm 1( t,l7,U r ml M , i “o. SSS1Cm °t“ establishing contact with Ftp Server 

processes that run all the time on those machines. Hence, one may simply invoke the Alto Ftp 

subsystem and direct its Fip User process to connect to the machine 

that f0ll0W Tu the terms locaI 311(1 remote are relative to the machine on which the 
Ftp User program is active That is, we speak of typing commands to our local Ftp User program 
and directing ,t to establish contact with an Ftp Server on some remote machine ^A Retrieve 
command then copies a file from the remote file system to the local file system whereas a Store 
command copies a file from the local file system to the remote file system 

refer to J oca! and remote filenames. These must conform to the conventions used 

^e Alto FTP knZf n?h- COmP H UterS ’J hiCh ^ ay be dissimilar ( for example, Alto versus Maxc). 
ihe Alto FTP knows nothing about Maxc filename conventions or vice versa. 

term i nal °i n^Trnannlf™ o S0 inc , ludes 3 th “ d P rocess ’ cal]ed 3 User Tel ™l, which simulates a 
features) Rv thk ™ Uy anaI ? gous t0 Chat subsystem (though lacking some of its finer 

available % t, baste' fT Ssfcf ^taii^T" " Pe[f °"" ° perali0ns n0 * direC “ y 
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The 


or the 


2. Calling the FTP subsystem 

A number of options are available when running Ftp. The program decides which parts of itself to 
enable and where user commands will come from by inspecting the command line. The general 
form of the command line to invoke Ftp looks like: 

> Ftp/ global- switches host-name command-list < ~' R 

All parts of the command line except the subsystem name Ftp are optional and may be omitted. 


;ol. 


2.1 Global switches 
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Global switches, explained below, select some global program options such as using the Trident disk 
instead of the Diablo. The first token after the global- switches, if present, is assumed to be a host- 
name (a discussion of which appears later in the description of the Open command). The User Ftp 
will attempt to connect to the Ftp Server on that host After connecting to the server, if a 
command-list is present, an interpreter is started which feeds these commands to the User Ftp. 
When the command list is exhausted. Ftp returns to the Alto Executive. If no command list is 
present, an interactive keyboard command interpreter is started. 

Each global switch has a default value which is used if the switch is not explicitly set To set a 
switch to false precede it with a minus sign (thus Ftp/ — S means "no Server”), to set a switch to 
true just mention the switch. 


Switch 

Default 

Action 

/S 

true 

[Server] starts the FTP Server. The Server is not started if the User is 
enabled and is being controlled from the command line. 

/U 

true 

[User] starts the FTP User. As explained above, the interactive command 
interpreter or the command line interpreter will be started depending on 
the contents of the command line. 

/C 

true 

[Chat] starts the Telnet. The Telnet is not started if the User is enabled 
and is being controlled from the command line, or if the system disk is a 
Trident 

rv 

false 

[Trident] sets the system disk to be a Trident drive. The default is 0, but 
can be changed by following the /T with a unit number between 0 and 7 
(thus FTP/T5 means use Trident unit 5). User and Server commands 
apply to files on this disk but command line input is still taken from 
Com.cm on the Diablo drive. 

fL 

false 

[Log] causes all output to the User FTP window to also go to the file 
Frp.log on DPO, overwriting the previous contents. Log is true if the 
User is enabled and is being controlled from the command line. 

/A 

false 

[AppendLog] enables the log but appends to FTp.log rather than 
overwriting it 

/E 

true 

[Error] causes FTP to ask you if you want to continue when a non-fatal 


error happens during execution of a command line. FTP/ — E will cause 
FTP to recover automatically from non-fatal errors without consulting 
you. 



/R 

true 

[Ram] allows Ftp to use some microcode which speeds things up slightly. 
If your Alto has no ram, this switch is ignored. 

/B 

false 

[Boot] creates FTP.Boot 

for distribution to boot servers. 

/D 

false 

[Debug] starts FTP in 

debug mode. 


The rest of the global switches are explained below under "Server Options". 


2.2 Ftp user log 



FTP can keep a log (typescript) file for the FTP User window. The file name is FTP.log. It is 
always enabled when Ftp is being controlled from the command line; otherwise it is controlled by 
the /L and /A global switches. Some keyboard commands do not treat the user window as a 
simple teletype, so the typescript for these commands will not be exactly what you saw, alas. 


2.3 Using a Trident disk 


Starting FTP with the /T global switch causes FTP to access local files on a Trident disk (assuming 
one is connected) rather than on the standard Diablo disk. Accessing a file on a Trident requires 
more code and more free storage than accessing a file on the Diablo. Since FTP is very short on 
space, only a User or a Server FTP is started when the /T switch is set. The default is to start a 
User Ftp, but specifying no user (FTP/T - U) or specifying a server (FTp/TS) will start a Server FTP 
instead. 


2.4 Server options 


Server options are controlled by global switches and by subcommands of the Server keyboard 
command. There are currently four options: 


Switch 

Default 

Action 

none 


If no server option is specified, retrieve requests (disk to net) are allowed. 
Store requests (net to disk) are allowed unless the store would overwrite 
an already existing file. Delete and Rename are not permitted. 

fP 

false 

[Protected] Retrieve requests are allowed. Store, Delete, and Rename are 
not permitted. 

/O 

false 

[Overwrite] Retrieve requests are allowed. Store requests may overwrite 
files. Delete and Rename are permitted. 

/K 

■I 

false 

[Kill] FTP will return to the Alto Exec when the server connection is 
closed. A simple form of remote job entry can be performed if the user 
FTP stores some Executive commands into Rem.cm. 

2.5 The 

FTP display 



The top inch or so of the display contains a title line and an error window. The title line displays 
the release date of that version of FTP, the current date and time, the machine’s internetwork 
address, and the number of free pages on the disk. The error window displays certain error 
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messages if they arrive from the network (errors are discussed in more detail below). A window is 
created below the title line for each part of Fit that is enabled during a session (server, user, and 
telnet). 

If the Ftp Server is enabled, it opens a window and identifies itself. If a User Ftp subsequently 
connects to this Server, the User’s network address will be displayed. The Server will log the 
commands it carries out on behalf of the remote User in this window. The Server is not enabled 
when Ftp is being controlled from the command line. 

The Ftp User opens the next window down and identifies itself. The command herald is an 
asterisk. 

The User Telnet opens the bottommost window, identifies itself, and waits for a host name to be 
entered. The Telnet is not enabled when Ftp is being controlled from the command line. 





3. Keyboard command syntax 

Ftp’s interactive command interpreter presents a user interface somewhat similar to that of the Alto 
Executive. The standard editing characters, command recognition features, and help facility (via 
"?") are available. When Fit is waiting for keyboard input, a blinking cursor will appear at the 
next character position. 


3.1 Directing keyboard input to the User and Telnet windows 

The bottom two unmarked keys control which window gets characters from the keyboard. Striking 
the unmarked key to the right of the right-hand SHIFT key directs keyboard input to the Telnet 
window. Striking the unmarked key to the right of the RETURN key directs keyboard input to the 
Ftp User window. A blinking cursor will appear in the window that owns the keyboard if the 
window is awaiting typein. 


1 3.2 Keyboard commands 
*Open host-name CR 

Opens a connection to the Fit Server in the specified host Ftp permits only one user FTP 
connection at a time. In most cases the word "Open" may be omitted: i.e., a well formed host- 
name is a legal command and implies a request to Open a connection. Ftp will try for one minute 
to connect to the specified host. If you made a mistake typing host-name and wish to abort the 
connection attempt, hit the middle unmarked key (to the right of RETURN). 


Ordinarily, host-name should be the name of the machine you wish to connect to (e.g., Maxc). 
Most Altos and Novas have names which have been registered in Name Lookup Servers. So long 
as a name lookup server is available, FTP is able to obtain the information necessary to translate a 
known host name to an inter-network address. 

If the name of the server machine is not known, you may specify an inter-network address in place 
of the host-name. The general form of an inter-network address is: 
network # host # socket 

where each of the three fields is an octal number. The network number designates the network to 
which the Server host is connected (which may be different from the one to which the User host is 
connected); this (along with the that follows it) may be omitted if the Server and User are 



Ftp Reference Manual 


^Ztne^ designates the Server host’s address 

should be omitted, since the default is the regular Ftp ^er process on that host; ordinarily it 

*C]ose CR 

Closes the currently open User Prp connection. 

Login user- name password 

misuse *7 use^nam^nd^aTsword^n^the^p^atfn^System^T di Wi ” ^ transfers ' Prp 

Ftp will pass them hade to the OS in the 

If you now type a space" F tp* wfi7pr<M P ryou for d a Play 1116 USer name known to the OS. 
different user name you should first tvn/ r w P assw ord, whereas if you want to provide a 

followed by a space.’ The command may be teminaTed °? llterat f C the previous one) 

name to omit entering the password. ^ termina ted by carnage return after entering the user 

checking when the Viref file nansferco^and ifLsufd'^If a^le"^ 61 ^ f” SCnt t0 1116 Smer for 
the server because the name or password is incorrect Ftp win n n transfer C0I ™nand is refused by 

asr ^ ■ h ' «“*' -«“«*■ ss s 

- 'SEisras Ke?^esT u ^„s f i™ 8 "jv?,*? ftom a - 

password-protected and if the password in th e P se7er llrir ‘ f the Server machine ’ s disk is 

the disk. Thus if the OS was boSted and Ffr mat , Ch 1116 P assword ™ 

received (which bypasses password checking) Ftp will rpfncA US£ 3 P< ^ uest "f° r "Connection was 
supplied However if the OS was booted notia^ f£ assumes'thaf ,h° jP? paSSWOrd is 

password, w.,1 cootrol « ess by using „ 

Connec t directory- name password ^ 

■“»* system, i.e. ,o give 

name. As with Login, these parameters are not%erifa77,ci b fh tyPmg RETURN after the directory 

^st?m o" °^7^1 17° F?^ a s7rver 7u ° nlV ^ toTfrom VS 

feature of the «o Operadng System eJlSTESS^WSttSSS 

*Directory directory- nrnnp*-^ 

mention a directory). Specifying defauk Sir7m7 f n ” £ ° tC file “ 11131 do not explicitly 
whereas connecting gives you owner access fanfi „c„Jn n ° way modlPies y° ur access privileges, 

tanyy s ss as? 

2s. ,iien " K shouid not be “ ut " d - f ” 
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*Retrieve remote- filename^ 


Initiates transfer of the specified remote file to the local host The syntax of remote-filename must 
conlorm to the remote host’s file system name conventions. Before transferring a file, FTP will 
suggest a local-filename (generally the same as the remote-filename without directory or version), and 
will tell you whether or not the file already exists on your local disk. At this point you may make 
one of three choices: 

1. Type return to cause the data to be transferred to local-filename. 

2. Type del to indicate that the file is not to be transferred. 

3. Type any desired local-filename followed by RETURN. The previous local-filename will 
disappear, the new filename will replace it and FTP will tell you whether a file exists 
with that name. This filename must conform to Alto conventions. You now have the 
same three choices. 

If remole-filename designates multiple files (the remote host permits or some equivalent in file 
names), each file will be transferred separately and FTP will ask you to make one of the above three 
choices for each file. At present only Maxc and Ifs support this capability. That is, you may 
supply "*”s in the remote-filename when retrieving files from a Maxc or Ifs but not when 
retrieving files from another Alto. 

*Store local-filename ^ 

Initiates transfer of the^ specified local file to the remote host Alto filename conventions apply to 
the local- filename, * expansion is not supported. FTP will suggest a remote-filename, to which 
you should respond in a manner similar to that described for Retrieve except that if you supply a 
different filename, it must conform to the remote file system’s conventions. The default remole- 
filename is one with the same name and extension as the local file; the remote server defaults other 
fields as necessary. If the remote host is a Maxc system or an Ifs, then the directory is that most 
recently supplied in Login, Connect, or Directory commands and the version is the next higher. 

*Dump remote filename^ 

Bundles together a group of files from the local file system into a dump-format file (see the Alto 
executive documentation for the dump-file format and more on dump-files in general) and stores 
die result as remote-filename. FTP will ask you for the names of local files to include in the dump- 
hle. Terminate the dump by typing just return when FTP asks for another filename. By 
convention, files in dump-format have extension rim 

* Load remote-filename ^ • 

Performs the inverse operation of Dump, unbundling a dump-format file from the remote file 
system and storing the constituent files in the local file system. For each file in the dump-file, FTP 
will suggest a local file name and tell you whether a file by that name exists on your disk. You 
should respond in the manner described for Retrieve. 

*List r emote- file- designator*-**- 


Lists all files in the remote file system which correspond to remote- filer designator. The remote-file- 
designalor must conform to file naming conventions on the remote host, and may designate multiple 
hies if expansion or some equivalent is supported there. 

remo!e ~f ll ^ desi S na lor is terminated by a comma rather than RETURN, FTP prints a prompt of 
at the left margin and prepares to accept one or more subcommands. These subcommands 
request printout of additional information about each file. To terminate subcommand input, type 
Return in response to the subcommand prompt The subcommands are: 
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Type 

Print 

file type and byte size. 

Length 

Print 

length of file in bytes. 

Creation 

Print 

date of creation. 

Write 

Print 

date of last write. 

Read 

Print 

date of last read. 

Times 

Print 

times as well as dates. 

Author 

Print 

author (creator) of file. 

Verbose 

Same 

as Type Write Read Author. 

Everything 

Print 

all information about the file. 


This information is only as reliable as the Server that provides it, and not all Servers provide all of 
these file properties. Altos derive much of this information from hints, so do not be alarmed if it is 
sometimes wrong. 


*Delete remote- filename^ 

Deletes remote-filename from the remote file system. The syntax of the remole-filename must 
conform to the remote host’s file system name conventions. After determining that the remote file 
exists. Ftp asks you to confirm your intention to delete it. If the remote-filename designates 
multiple files (the remote host permits or some equivalent in file names), FTP asks you to 
confirm the deletion of each file. 

* Ren ame old-filename new- filename^ 

Renames old- filename in the remote file system to be new- filename. The syntax of the two 
filenames must conform to the remote host’s file system name conventions, and each filename must 
specify exactly one file. 

*QuitOt 

Returns control to the Alto Executive, closing all open connections. 

*Type data- type 

Forces the data to be interpreted according to the specified data- type, which may be Text or Binary. 
Initially the type is Unspecified, meaning that the source process should, if possible, decide on the 
appropriate type based on local information. 

*Byte-size decimal- number CK 

Applicable only to files of type Binary, Byte-size specifies the logical byte size of the data to be 
transferred. The default is 8. 

*EO L convention CR 

Applicable only to files of type Text, this command specifies the End-of-line convention to be used 
for transferring text files. The values for convention are CR, CRLF, and Transparent The default is 
CR. 


*User_... 

Allows you to toggle switches which control operation of the Ftp User. There is currently only one, 
Debug, which controls display of protocol interactions. Warning: this printout (and the 
corresponding one in the Server command below) sometimes includes passwords. 
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*Server_... 

Allows you to toggle switches that control operation of the Ftp Server. The switches are Protected, 
Overwrite, Kill, and Debug, corresponding to the global switches /P, /O, /K, and /D. 
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♦Telnet ... 

Allows you to toggle switches that control operation of the Telnet. There is currently only one. 
Close, which closes the Telnet connection if one is open, and clears the Telnet window. 


4, Command line syntax 

The User Ftp can also be controlled from the command line. As explained previously, the first 
token after the subsystem name and global- switches must be a legal host-name\ if the User Ftp cant 
connect to the Ftp Server on that host it will abort and return control to die Alto Executive. If a 
command-list follows the host name, the command line interpreter is looked instead of the 
interactive keyboard interpreter. This permits the full capabilities of the Alto Executive ^(filename 
recognition, expansion, command files, etc.) to be used in constructing commands for FTP. 

Each command is of the form: 

keyword/ switch-list argument ... argument 

To get a special character (any one of *#*;) past the Alto Executive, you must precede it by a 
single quote To get a ”/” into an FTP argument, the "/" must be proceeded by two single quotes 
(the second one tells FTP to treat the "/” as an ordinary character in the argument, and the first one 
gets the second one past the Alto Executive). 

Unambiguous abbreviations of commands are legal. However, when constructing^ command files, 
you should always spell commands in full, since the uniqueness of abbreviations m the present 
version of Ftp is not guaranteed in future versions. 

A command is distinguished from arguments to the previous command by having a switch on it, so 
every command must have at least one switch. The switch /C has no special meaning and should 
be used on commands where no other switches are needed or desired. 
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4.1 Command line errors 

Command line errors fall into three groups: syntax errors, file errors, ; and connection i eirors. Ftp 
can recover from some of these, though jt leaves the decision about whether to try up to you. 

Syntax errors such as unrecognized commands or the wrong number of arguments to a command 
cause FTP’s command interpreter to get out of sync with the command file. FTP can recover from 
syntax errors by simply ignoring text until it encounters another command (i.e., another token with 

a switch). 

File errors such as trying to retrieve a file that does not exist are relatively harmless. FTP recovers 
from file errors by skipping the offending file. 

Connection errors such as executing a store command when there is no open connection could 
cause FTP to crash. FTP can’t recover from connection errors. 
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When Ftp detects an error, it displays an error message in the User window. If the error is fatal. 
Ftp waits for you to type any character and then aborts, causing the Alto Executive to flush the rest 
of the command line, including any commands to invoke other subsystems after Ftp. If Ftp can 
recover from the error, it asks you to confirm whether you wish to continue. If you confirm, it 
plunges on, otherwise it aborts. The confirmation request can be bypassed by invoking FTP with 
the global error switch false ( FTP/ — E ...) in which case it will plunge on after all non-fatal errors. 
If you aren’t around when an error happens and you have told Ftp to get confirmation before 
continuing after an error, the remote Server will probably time out and close the connection. If you 
then return and tell Ftp to continue, it will get a fatal connection error and abort 

4.2 Command line commands 
Open/C host-name 

See the description in "Keyboard commands”. The first token after the subsystem name and global 
switches is assumed to be a host name and no Open verb is required (in fact, if you supply it, FTP 
will try to make a connection to the host named Open, which is almost certainly not what you 
want). 

Close/C 

Closes the currently open User FTP connection. 

Login/C username password 

See description in "Keyboard commands". The password may be omitted. 

Login/Q username 

Causes FTP to prompt you for the password. This form of Login should be used in command files 
since including passwords in command files is bad practice. 

Connect/C directory-name password 

See description in "Keyboard commands". The password may be omitted. 

Connect/Q directory-name 

Causes FTP to prompt you for the password needed to connect to the specified directory- name. This 
foim of Connect should be used in command files since including passwords in co mm and files is 
bad practice. 

Directory/C directory-name 

See description in "Keyboard commands". 


Retrieve/C remote-filename ... remote-filename 

Retrieves each remote-filename , constructing a local filename from the name body of the actual 
remote filename as received from the Server. FTP will overwrite an existing file unless the /N (No 
overwrite) switch is appended to the Retrieve command keyword. 
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If the remote host allows (or some equivalent) in a filename, a single remole-filename may result 
m the retrieval of several files. (Note that one must quote the to get it past the Alto 
Executive s command scanner.) As noted previously, this capability is implemented only by the 
Maxc and Ifs Ftp Servers at present 

Retrieve/S remote-filename local-filename 

Retrieves remole-filename and names it local-filename in the local file system. This version of 
Retrieve must have exactly two arguments. Ftp will overwrite an existing file unless the /N (No 
overwrite) switch is also appended to the Retrieve command keyword. The remole-filename should 
not cause the server to send multiple files. 

Retrieve/U remote-filename ... remole-filename 

Retrieves remote-filename if its creation date is later than the creation date of the corresponding 
local file. A file will be retrieved only if a file with the same name already exists on the local disk 
I his option may be combined with Retrieve/S to rename the file as it is transferred. 

Retrieve/V remote-filename ... remote-filename 

Requests confirmation from the keyboard before writing a local file. This option is useful in 
combination with the Update option since creation date is not a fool-proof criterion for updating a 

Store/C local-filename ... local-filename 

Stores each local-filename on the remote host, constructing a remote filename from the name body 
of the local- filename. A local- filename may contain since it will be expanded by the Alto 
Executive into the actual list of filenames before the Ftp subsystem is invoked. 

Store/S local-filename remote-filename 

Stores local-filename on the remote host as remote-filename. The remote-filename must conform to 
the file name conventions of the remote host This version of Store must have exactly two 
arguments. 3 

Dump/C remote-filename local-filename ... local-filename 
See the description in "Keyboard Commands". 

Load/C remote- filename 

See the description in Keyboard commands". If the /V switch is appended to the Load command 
Keyword, Ftp will request confimation before writing each file. Type RETURN to write the file DEL 
to skip it. Ftp will overwrite an existing file unless the /N (No overwrite) switch is appended to 
the Load command keyword. 

Delete/C remote-filename ... remole-filename 

See the description in Keyboard commands". If the /V switch is appended to the Delete 
command keyword. Ftp will request confirmation before deleting each file. Type return to delete 
toe file, and del if you don’t want to delete it 




Compare/C remote-filename ... remote-filename 

Compares the contents of each remote-filename with the file by the same name in the local file 
system. It tells you how long the files are if they are identical or the byte position of the first 
mismatch if they are not. (No corresponding command is available in the Keyboard command 
interpreter for implementation reasons: there is not enough room for it in Alto memory) 


Compare/S remole-filename local-filename 

Compares remote-filename with local-filename. The remote-filename must conform to the file name 
conventions of the remote host. This version of Compare must have exactly two arguments. 

Rename/C old-filename new-filename 

See the description in "Keyboard commands". 


Type/C data-type 

See the description in "Keyboard commands". 

Byte-size/C decimal- number 

See the description in "Keyboard commands". 

EOL/C convention 

See the description in "Keyboard commands”. 

Debug/C 

See the description of the Debug subcommand of the User command in "Keyboard commands". 


4.3 Command line examples 

To transfer files FTP.run and FTp.syms from the Alto called Michelson to the Alto called Morley, 
one might start up FTP on Michelson (to act as an FTP Server), then walk over to Morley and type: 

> Ftp Michelson Retrieve/c Ftp.run Ftp.syms CR 
Alternatively, one could start an FTP server on Morley (invoking it by FTP/O to permit files to be 
overwritten on Morley’s disk), then issue the following command to Michelson: 

> Ftp Morley Store/c Ftp.run Ftp.syms CR 

The latter approach is recommended for transferring large groups of files such as *.run (since 
expansion of the will be performed by the Alto Executive). 

To retrieve Uscr.cm from the FTP server running on Alto serial number 123 (name unknown, but it 
is on the local Ethernet): 

> Ftp 123’# Retrieve User.cm 0 * 

Note that the must be preceded by a single quote when included in a command line, since 
otherwise the Alto Executive does funny things with it (Quotes are not necessary when typing to 
Ftp’s interactive keyboard interpreter). 


To start FTP, have the FTP User connect to Ivy, and then accept further commands from the 
keyboard: 
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> Ftp Ivv CR 

To retneve <System>Pup-Network.txt from Maxc and store it on the Alto as PupDirectory. bravo 
unchanged- PUPRTRbCP ’ Puplb ’ bcp1 ’ and Pu PBSPStreams.bcpl on <DRB> with their names 

>Ftp Maxc C onnect/c drb mypassword Retrieve/s <Svstem>Pup-Network.txt 
PupDirectorv!br avo Store/c PupRTP.bcpl Puplb.bcpl PupBSPStreams.bcpl CR 

In [ at / C K COpy , of a11 - Run files from 1116 <Alto> directory on Maxc, overwriting copies 

on the local disk (the single quote is necessary to prevent the Alto Executive from expanding the 

> Ftp Maxc Ret/c <alto>’*.Run CR 

7° updat f the local disk with new c °P ies of all <Alto> files whose names are contained in file 
Updatehiles.cm, requesting confirmation before each retrieval: 

> Ftp Maxc Dir/c Alto Ret/u/v @UpdateFiles.cm@ CR 

To store all files with extension .Bcpl from the local disk to your login directory on Iris (the Alto 
Executive will expand *.bcpl before invoking Ftp): 

> Ftp Iris St/c *.Bcp1 cr 

To retrieve <System>Host-name/descriptor-file.txt;43 (two single quotes are necessary to get the "/" 
past the Alto Executive and the FTP command scanner, and one quote is necessary to get the 
past the Alto Executive): 3 5 ’ 

> Ftp Maxc Ret/c <System>Host-name”/descriptor-file.Pct > :43 CR 


tnds". 


be 


5. File Property Defaulting 

Without explicit information from the file system, it is often difficult to determine whether a file is 
Binary or Text, if Binary, what its byte-size is, and if Text, what End-of-line convention is used, 
the User and Server FTps use some simple heuristics to determine the correct manner in which to 
O-ansfer a file. The heuristics generally do the right thing in the face of incomplete information, 
and can be overridden by explicit commands from a human user who knows better. 

The FTP protocol specifies a standard representation for a file while in transit over a network. If 
tne hie is of type Binary, each logical byte is packed right-justified in an integral number of 8-bit 
bytes. Ihe byte-size is sent as a property along with the file. If the file is of type Text, each 
character is sent right-justified in an 8-bit byte. . An eol convention may be sent as a file property 
Ihe default is that RETURN marks the end of a line. 


the 


5.1 File types 

FTp determines the type of a local file by reading it and looking for bytes with the high-order bit 
on. ll any byte in the file has a high-order bit on, the file is assumed to be Type Binary, otherwise 
it is assumed to be Type Text. FTP will generate a warning, but allow you to send what it thinks to 
text tCXt h C 3S tyPC Bmary ’ Slnce no information ^ lost - ft will refuse to send a binary file as type 


Moral: Don’t specify a Type unless you know what you are doing, 
lose information. 


The heuristic will not 
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5.2 Byte- size 

If a file is type Binary, the byte-size is assumed to be 8 unless otherwise specified. The Ftp User 
and Server will both accept binary files of any byte-size and write them as 8 bit bytes on the disk 
o transformation is done on the data as it is written to the disk: it is stored in network default 
format. Since there is no place to save the byte-size property, it is lost. 

Similarly, requests for Binary files will be honored with any byte size, and whatever is on the disk 
l c 6 SCnt t0 Ql£ u lth ? U J transformation. Since Alto files have no byte-size information the 

byte size property will be defaulted to 8 unless otherwise specified, in which case whatever’ was 
otherwise specified will be returned as the byte~size. 

Moral: Don’t specify a Byte-size unless you know what you are doing. Alto- Alto transfers 
cant go wrong. Alto-Maxc transfers with weird byte-sizes will not work unless the byte-size 
specified in the Alto to Maxc direction is the same as the byte-size in which the file was 
stored on the Alto. If it isn’t, the Alto will not give any error indication, but the result will 
be garbage. 

5.3 End-of-line conventions 

Ftps are expected to be able to convert text files between their own internal EOL convention and 
£e network standard. Conveniently enough, the Alto file system’s internal representation of a text 
file is the same as the network standard. The Alto Ftp does not do any transformations on St 
es. It will refuse to store a text file coming in from the net whose EOL convention is CRLF. 

es “ pe 1° by P ass conversion and checking, eol convention Transparent tells both ends not to 
convert to network standard, but rather send a file as-is. This is included for Lisp files which 
contain internal character pointers that are messed up by removing LFs. 

P 0 ? 1 SpeClfy an „^ 0L conv ention unless you know what you are doing. If your text 
file is a Lisp source file, specify EOL convention Transparent. 


5.4 File dales 

The Alto file system keeps three dates with each file: Creation, Read, and Write Ftp treats the 

wri?ten n 1nThP £5 fii pr0p t erties d ^ ribin 8 ^e local copy of a file: when the file was last read and 
Z n! te V n m 16 003 fi e system ; . Feats the creation date as a property of the file contents: 
^en the file contents were originally created, not when the local copy was created. Thus when 

remn^Rrp 3 ftZ on the lc f al . dlsk > the creation date is set to the creation date supplied by the 
emote Ftp, the write date is set to now" and the read date is set to "never read". 


i 
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6. Abort and error messages 

Error and Abort packets are displayed in the system window. Abort packets are fatal; Error packets 
are not necessarily so. 


|p. 

jigw 


The most common Abort message is "Timeout Good bye", generated when a server process has not 
received any commands for a long time (typically 5 minutes). 

The most common Error message is "Port input queue overflowed" indicating a momentary 
shortage of input buffers at the remote host Receiving an Error Pup does not imply that the file in 
transit has been damaged. Loss of or damage to a file will be indicated by an explicit message in 
the User Ftp window. The next iteration of Pup will probably rename Error Pups to be 
Information Pups. 


7. Telnet 

FTP provides a simple User Telnet, as a convenience for logging into a remote host (e.g., Maxc) to 
poke around without having to leave the Ftp subsystem and start Chat It lacks most of the 
creature comforts Chat provides, such as automatic attaching to detached jobs, automatic logging in, 
etc. The Telnet is not enabled when the User Ftp is being controlled from the command line. 
When the Telnet does not have an open connection, it waits for you to type a host name with the 
syntax explained above for the Open command, and then attempts to connect to the specified host 
If you wish to abort the connection attempt, hit the bottom unmarked key (opposite the right-hand 
SHIFT key). You can get a larger Telnet window by not starting a server (type FTP/— S to the 
Executive). 
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4. Commands 

Neptune is controlled partially by the mouse and partially by the keyboard. You can do three 
things using the mouse: 

scroll the directory windows, much as in Bravo; 
select individual files that you want to manipulate; 
invoke commands. 

The keyboard is used only for text entry and for confirmation of certain commands invoked by the 
mouse. 
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A directory can be scrolled very much like a document in Bravo. Just to the left of each directory 
window there is an invisible scroll bar. When the cursor is over this bar, the cursor takes on the 
shape of a vertical double-headed arrow. Pressing and releasing RED inside the scroll bar moves the 
text opposite the cursor to the top of the window, blue scrolls in the opposite direction, moving 
the text at the top of the window down to the cursor position. While you are holding down RED or 
BLUE, the cursor changes to an upward or downward-pointing arrow, respectively. 

YELLOW positions the directory in the window in proportion to the cursor’s position along the left 
edge of the window. The top and bottom of the scroll bar correspond to the beginning and end of 
the directory. When you hold down yellow, the cursor turns into a triangle, and another, 
stationary triangle appears to show where the directory is presently positioned. 

The beginning and end of the directory are indicated by 

beginning 
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4.2 Selecting files and operations 

Neptune’s most useful operations on individual files are copy and delete. You select which files you 
wish to manipulate by pointing at them, and you specify which operation you want to perform on 
each one by clicking a particular mouse button. The operations are not performed immediately but 
are deferred until you invoke the Start command, which tells Neptune to perform them all. 

To select a file name, move the cursor over the name and press a mouse button. The button does 
not have to be released over the name for the file to be selected. This means that you may select a 
number of adjacent files by holding down the mouse button and sweeping the cursor over the 
group of names. 

There are three possible operations, corresponding to the three mouse buttons. Selecting a name 
with a mouse button has one of the following meanings, depending on which button you press: 

Make a copy of this file in the other directory. 

Copy this file under a different name. 

Delete the file from this directory. 
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While a name is selected it is displayed white-on-black rather than black-on-white. The operation 
that is to be performed is indicated by a special symbol in the narrow column along the inner edge 
of the directory window. This operations column is separated from the directory names by a gray 
line. 

I 

If you select a file name with red, an arrow will appear in the operations column, pointing toward 
the other directory, indicating that the file is to be copied into the other directory. If you select the 
file with YELLOW rather than RED, Neptune will immediately request that you type a name 
(terminated by cr or esc) which is to be the new name of the file in the other directory. This 
name will be displayed just below the selected file name, with the words "change to" in the 
operations column. 

I 

If you select a file name with BLUE, a large X will appear next to it in the operations column 
indicating that the file is to be deleted. 

If you select a file name that is already selected, the file name will be deselected and the operation 
on that file cancelled. 

When you are satisfied with the selections, start execution of the operations by positioning the 
cursor over Start (in the upper-left comer) and clicking red. Neptune will now begin performing 
the operations you have selected, displaying messages in the system window to tell you what it is 
doing. When it is done, it will update the directory windows and say "ready” in the system 
window. You may select a maximum of 100 files before issuing the Start command. Operations are performed in the 
order that they were selected. Neptune may turn off part of the display while it is performing the operations This is 
so that it can use the memory occupied by the display bit map as buffers to speed up disk transfers 


4.3 Changing the filter 

Initially, all the file names in a directory are displayed in that directory’s window. You can change 
this by specifying a file name pattern or filter to describe some subset of the file names you wish 
Neptune to display. The filter currently being used to display a directory is shown underneath its 
status window, along with the disk drive and directory name; this appears something like 
DPO: <SysDir> *.* 

In this case, DPO is the disk drive, SysDir is the directory name, and *.* is the filter When you 
start up Neptune, the initial filter for each window is *.*, which matches all files. 

To change a filter, position the cursor over the existing one and click red. A small b linkin g square 
will appear to the left of the filter. Next, type the new filter, terminated with cr, esc, or tab. All 
the file names that match this filter will now be shown in the corresponding directory window. 
You may include * in the filter to match any sequence of characters, just as in the Alto Executive. 
If you strike del while typing the filter, the default filter *.* will be used. 

When you change a filter, any file operations you have selected but not yet executed in the affected window are 
cancelled. This avoids any possible confusion about file names that are selected but are not visible in the directory 
window because they don’t match the new filter. 


4.4 Displaying a file 

Neptune can display file attributes and contents in much the same fashion as the Executive’s 
FileStat and Type commands. To display a file, position the cursor over Type (near the upper-right 
comer of the screen) and click RED. 

At this point, Neptune will temporarily deselect any file names that you may have selected 
previously, and a message will appear in the system window requesting you to select a file name. 
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5. Disks and directories 

rmiwmmmmm 
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® lv . en disk there one or more directories containing the names of files stored on that 
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5.1 Switching to a different disk 

1 diSk dr l ve u r 016 left or right side of the screen. Position the cursor over the 
currenr disk dnve name for that side and click red. Neptune will clear out the directory window 
and dis play ,n its place the names of all possible disk drives, i.e., all drives that are connected to the 
Alto and that have disk packs loaded and ready. Choose the desired disk drive by pointing at its 
name and clicking red. p 6 

If the disk you selected is password-protected (i.e., a password was specified when the Operating 
System was installed on that disk), Neptune will require you to enter the password at this time. 

7777 • have chosen onc of the disk drives, Neptune will look for directories on the disk loaded 
"re?dv" y only directory present will be SysDir, and Neptune will revert to its 

ready state after displaying the directory m the normal fashion. On the other hand, if the disk 

Nep, “ ne wl “ now ^ *>“ “'»• o* 4 of 

Directly following the list of available disk drives is the phrase "No Disk" Selectine this rather 
Jan a di sk dnve name leaves that side of the screen undefined, i.e., not efemng to any dS cWve 

is r zz ,s wi.“ by '' n ° Disk “ - * *•» 

5.2 Switching to a different directory 

SStoriS khTordeT The h o n f C fi 1 !? CUrrent dl . re 5 tory name . a warning about the use of alternate 
dr ones is in order. The only fully-supported directory in the Alto file system is the one called 

SysDir. The Operating System does give limited support to other directories, but not all Alto 

To change the ^ directory name for a window, point at the current one with the cursor and click red 

h P P 7"L W 7 lo ? k for direct0 J ry fi,es on 1116 curre nt disk. All the directories thatit finds^wili 
be displayed in the directory window. Choose the desired directory by pointing at its name and 

state!" 8 ' NeptUne Wl11 now display 1116 file names in 11131 directory and revert to its "ready" 

ipn°ir Sh t0 Cr , eate a new directory rather than selecting an existing one, then instead of clicking 

n7r a 7A eX1St ^ 8 77 SUnply type 016 new directory name followed by CR or ESC. There must 
not already be a file by that name. After you have done this, the directory window will of course 

dL^' Jn°do7 n n ° W PUt fUeS mt ° 11115 newly ' Crealed directory by c °P ydl g them from the other 




Technical Library A3-2E 
XEROX CORPORATION 
701 S. AVIATION 
EL SEGUNDO, CA 9024 



